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PREFACE 



The CONTROL DATA® Concurrent Maintenance Library (CML) is a collection of programs developed 
to improve the support functions for Engineering Services personnel in the diagnosis and 
repair of malfunctions occurring in CDC® CYBER 70, CDC CYBER 170/180 Computer Systems, and 
6000 Computer Systems. Revisions to existing programs and new programs can be added as 
required. 
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INTRODUCTION 



To understand the purpose and advantages of on-line maintenance , it is necessary to 
understand basic system maintenance concepts. This section presents these concepts, lists 
the goals of the hardware maintenance features, and shows how these goals are accomplished. 



TRADITIONAL MAINTENANCE APPROACH 

The traditional approach to system maintenance assumes that user time and preventive 
maintenance (PM) time are employed solely for the purposes indicated by their names. It 
further assumes that failures will occur, for which emergency maintenance (EM) will be 
necessary. 

However, time taken for EM is irrecoverable user time, as is the time between system failure 
and failure detection [mean time to detection (MTTD)]. MTTD represents rerun time for the 
user and is added to EM time to find total time lost to the user (figure 1-1). 

Part of the PM time is traditionally used running diagnostic programs that have error 
detection as the goal. It is hoped that enough PM time remains for error correction. If 
not, more user time must be taken for PM to ensure effective system operation. 



TOTAL TIME 
LOST TO USER 



USER 



EM 



MTTD 





FAILURE 





TIME ►- 



Figure 1-1. User Time Versus Maintenance Time 
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ON-LINE MAINTENANCE APPROACH 

The philosophy of concurrent or on-line maintenance concerning user time and PM time differs 
from the traditional approach. PM time is used for prevention of failures rather than 
detection. A small amount of user time is employed for checking correct system operation by 
the automatic execution of on-line diagnostics at preselected intervals (figure 1-2). 

The following three goals summarize the purpose of on-line maintenance. 

• Increased system availability: the ability to detect and repair faults in a 
real-time manner allows greater user access. 

• Increased system reliability: constant checking of system viability shakes loose 
potential failures and hidden problems, resulting in an increasingly reliable system. 

• Increased user confidence: the user always knows the level of system operability. 

These goals are achieved because the on-line maintenance system includes the following 
in ter ac t ing feat ures . 

• Real-time failure detection, isolation, and correction. 

• More efficient use of PM periods. 

• Minimal emergency downtime. 

On-line diagnostics, which are run at preselected intervals, detect failures shortly after 
they occur, significantly reducing the time between failure and detection. Failure 
information is entered in the dayfile and presented to system personnel in the form of a 
printout. It is also entered in the engineering file for future reference and analysis. 
The file can be used as a running account of system operation, enabling the user to easily 
find the time and nature of failures. These factors combine to save a considerable amount 
of rerun time. 




Figure 1-2. User Time Versus On-Line Diagnostics Time 
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When a failure is detected, isolation and correction can be attempted using additional 
diagnostics. The information logged in the engineering file can be used to aid in isolating 
the failure. If it is impossible to isolate and correct the failure on-line, it then must 
be determined whether the system can continue to operate effectively with the failure. 

As the flowchart (figure 1-3) illustrates, the goal is to maintain effective system 
operability despite occasional hardware malfunctions. 




SYSTEM 

USER AND 

DIAGNOSTICS 




NO / ERROR 
.DETECTED, 



YES 




RECOVER 



MORE 
DIAGNOSTICS 




YES 



YES 




UNSCHEDULED 

EMERGENCY 

REPAIR 



SCHEDULED 
REPAIR 



MORE 
DIAGNOSTICS 



NO 




IDLE DOWN 



IDLE UP 



YES 



NOTE FAILURE 

FOR HISTORICAL 

ANALYSIS 



DEAD START 



G> 



Figure 1-3. Maintenance Flowchart 
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PM time is not used for EM. PM time is used to prevent failures by performing regularly 
scheduled procedures, including replacement of suspected components. On-line maintenance 
releases PM time from the running of diagnostics (failure detection). It also provides, 
through its logging capability, system status information valuable to efficient planning and 
use of PM periods. 

On-line maintenance recognizes and curbs system degradation before collapse occurs. It 
detects minor malfunctions and takes proper action before a fatal system failure results. 
Degradation in a system is inevitable, but it can be controlled by proper application of 
on-line maintenance. 

If system failure does occur and EM is required, the engineering file contains information 
that aids system personnel in the isolation and correction of the failure. 

In summary, user confidence in the system depends upon the knowledge that the system is 
reliably available and operating at maximum efficiency. 

On-line maintenance ensures confidence. Down-time is significantly reduced, if not 
eliminated, because the system recognizes and reports degradation before system failure. PM 
time is used for failure prevention, as intended, rather than for failure detection, as in 
off-line diagnostics. Failures, whether minor or major, are detected much sooner than they 
would be by the PM diagnostics. Early detection greatly reduces the necessity of job 
reruns, which increases availability. Because on-line maintenance can log malfunction 
information in the engineering file and can point out the information shortly after the 
failure occurs, the state of the system is known at all times. Waiting until PM to learn if 
jobs are successful is not necessary. Test results are more accurate and believable 
because the system is tested in the user environment under the operating system rather than 
in an off-line mode. 



CONCURRENT MAINTENANCE LIBRARY (CML) 

CML comprises three major types of diagnostics described in this manual. 

Section 2 MALET Language 

Section 4 Input/Output Confidence Level Tests 

Section 5 Microcode Verification Process 

MAINTENANCE APPLICATION LANGUAGE FOR EQUIPMENT TESTING (MALET) 

MALET is a computer maintenance language used to write diagnostic application-type programs 
that perform peripheral device fault isolation. 
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INPUT/OUTPUT CONFIDENCE LEVEL TESTS 

The tests comprise the TIO on-line check of I/O operations and the REGEN on-line test 
program. The TIO assesses the performance of mass storage devices, tapes, and disks. The 
REGEN program provides validation of system data paths, verification of data relative to 
hardware and software, and verification of the central memory and the capability of the 
central processor unit to execute further diagnostic tests. 

ENGINEERING FILE 

The engineering file provides data for effective preventive maintenance through a running 
account of system performance. This is provided by collecting and recording data on system 
hardware malfunctions detected by the operating system. 

MICROCODE VERIFICATION PROCESS 

The verification of microcode is a process that compares a suspected bad image of control 
store to a known good image. This is achieved by comparing the control store dump record on 
an Express Deadstart Dump (EDD) tape to the binary microde load module [contained on the 
CYBER initialization Package (CIP) tape], used during system installation. 

CML TAPE 

The Concurrent Maintenance Library (CML) executes under NOS and NOS/BE operating systems. 

The CML tape is labeled (VSN=CMLVSN), recorded in Scope Internal (SI) format, and consists 
of the following logical files: 

FILE 1 CML installation procedures, and Common Maintenance Software Interface 
(CMSI) procedures, which are written in CYBER Control Language (CCL). 

FILE 2 CML Program Library, in Update format with an asterisk (*) as its master 
control character. 

FILE 3 BUCAL binary of the buffer controller diagnostic MY8 (MY8BC) in a form 
compatible with the downline load requirements of MALET MY8. 

FILE 4 BUCAL binary of the buffer controller diagnostic BCX (BCXBC) in a form 
compatible with the downline load requirements of MALET BCX. 

FILE 5 TFL 2550 scratch file binaries. 

FILE 6 CR1 scratch file binaries. 

FILE 7 Binaries of the LCN tests (NDM, NDP, NDT) in a form compatible with the 
downline load requirements. 

FILE 8 Binary file of MCCOMP control store conversion program suitable for 
execution under NOS. 

FILE 9 Binary file of MCDUMP control store conversion program suitable for 
execution under NOS. 

FILE 10 Binary file of MTPLOT and DSPLOT suitable for execution under NOS. 

FILE 11 Binary file of SKEDULR suitable for execution under NOS. 

FILE 12 Binary file of MLTDOC suitable for execution under NOS. 

FILE 13 MALET diagnostic binaries suitable for loading under NOS. 
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CML INSTALLATION 

The CML installation procedures contained on deck CMLINST are designed to perform an initial 

installation of the CML components into the NOS or NOS/BE operating system, or upgrade the 

level of existing CML components contained on the system. The major functions performed by 
these procedures include: 

Create the permanent file CMLINST containing CMSI and CMLUTIL, 

Assembly of MALET, HPA, REGEN, and TIO, 

Assembly of the PP routines MID and SBP, 

Optional incorporation of these binaries into the running system, 

The building of a new deadstart tape that includes these binaries (NOS only), 

Assembly of SKEDULR, DSPLOT, MLTDOC, and MTPLOT, and retention of the binaries on 
permanent files, 

Optional compilation of microcode utilities MCCOMP and MCDUMP and retention as 
permanent files , 

Compilation of the MALET diagnostics necessary to support the specified equipment 
configuration, 

Optional generation of hardcopy documentation for all compiled MALET diagnostics, and 

Incorporation of local modifications or corrective code into any of the 
assembled/compiled binaries. 

When called into execution, the procedures create installation jobs (CML1 through CML6) that 
are tailored to the specific hardware, software, and operational environment that the user 
defines. The jobs are saved as permanent files for subsequent execution. 

The procedures are called into execution directly from the CML tape by using a BEGIN 
statement to pass the hardware, software, and operational environments to the procedures. 
The procedures then execute and create the CML installation jobs, which are tailored to meet 
the specific requirements of the installation. Following this, a ROUTE statement starts 
execution of the first installation job. 

Execution of the installation jobs is begun by routing the first job (CML1) to the input 
queue. The remaining installation jobs are routed at the proper time in the sequence. 
These jobs are designed to make optimum use of system resources, thus minimizing 
installation time. 

Typical execution times for NOS, reflecting no other activities in the system, are as 
follows : 

CPU Wall-Clock Time 

CYBER 170-825 49 minutes 
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RESOURCE REQUIREMENTS (NOS) 

Magnetic Tape/Permanent File Requirements 

Installation jobs require the magnetic tapes or their permanent file equivalents listed in 
table 1-1 to be available. All magnetic tape requests issued by the installation jobs 
contain a VSN parameter, which causes the job to be rolled out until the request is 
satisfied. The tape requests can then be viewed via the E,P console display. All magnetic 
tapes can be mounted and the VSN assigned prior to the initiation of the installation 
process, thus avoiding the need to use the E,P display. 



Table 1-1. NOS Installation Jobs Resource Requirements (Sheet 1 of 2) 



Magnetic 
Tape VSN 



CMLVSN 



REL1A 
(NOS L602 
and below) 



Permanent 
File 



N/A 



User 
Defined 



Used 
In Job 



CML1 



CML2, 
CML3 



Comments 



CML Program Library. Tape must be 1600 bpi, labeled, 
SCOPE Internal format, without the Write Enable 
ring. Permanent file CMLPL is created from the 
Update Program Library (file 2) for use by subsequent 
installation jobs. Depending upon system 
configuration, various other files are copied from 
the tape and retained as permanent files. File CMLPL 
may be purged when installation is complete. 

REL1A Program Library. Tape must be NOS Internal 
format, labeled, without the Write Enable ring. The 
default VSN of REL1A and the default density of 1600 
bpi may be overridden through use of the OPLVSN and 
OPLDEN parameters. The installation job (CML2 or 
CML3) will create random access permanent file SYSOPL 
from the tape, which may be purged when installation 
is complete. 

Once permanent file SYSOPL is created, a rerun of the 
creating job (CML2 or CML3) will determine that the 
file already exists and will not request the tape 
again. 

If REL1A (frequently referred to as SYSOPL or OPL) is 
available on disk, it may be used in lieu of the 
magnetic tape. It must be a random access program 
library file in MODIFY format. The disk copy can be 
used by passing the permanent file name in parameter 
OPLPFN. The default user name for this file is 
LIBRARY, which may be changed through use of the 
parameter OPLUNID. If a password is required, it can 
be passed In parameter OPLPW. If the file exists on 
an auxiliary device, the pack name and device type 
are passed in parameters OPLPAK and OPLDTSET, 
respectively. If OPLDTSET is not specified, the 
default auxiliary device type defined at system 
installation will be assumed. 
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Table 1-1. NOS Installation Jobs Resource Requirements (Sheet 2 of 2) 



Magnetic 
Tape VSN 


Permanent 
File 


Used 
In Job 


Comments 


OLDDST 
NEWDST 


N/A 
N/A 


CML4 
CML4 


Old Deadstart Tape. Tape must be NOS Internal 
format, unlabeled, with no Write Enable ring. The 
requested density is the installation default. This 
tape is used as the basis for the generation of a new 
deadstart tape (NEWDST), which will contain the CML 
software. 

New Deadstart Tape. The tape is written in NOS 
Internal format at the installation-defined default 
density. The tape must be unlabeled and have a Write 
Enable ring installed. 



If a SYSEDIT is to be performed, job CML4 issues a dummy request for lfn S. This request is 
simply a warning to the operator of an impending SYSEDIT, and allows the network to be 
dropped and the system placed in DEBUG mode. When this has been accomplished, the request 
can be assigned to a disk or a null device. 



Validation Requirements 

Execution of the CML installation procedures requires the user to have the following minimum 
validation limits and permissions. All values are based on the released default values 
contained in system common deck COMSACC. All entries and numeric values listed are in octal 
notation. Not all entries apply to every operating system version and level. Refer to the 
system maintenance reference manual applicable to the system level on which the installation 
is to be performed. 

MODVAL 
Parameters Validation or Permission 

AP=IAF, User must be validated for IAF and/or RBF if installation is to be 
AP=RBF accomplished using interactive or batch terminals. 

AW=CLPF, The user must be able to create direct (CLPF) and indirect (CSPF) 

AW=CSPF, access permanent files, access system files (CASF), and request 

AW=CSOJ, nonallocatable devices (CAND). If REL1A (SYSOPL) resides on an 

AW=CASF, auxiliary device, the user must be validated to issue auxiliary device 

AW=CAND, commands. If a SYSEDIT is to be performed, the user must also be 

AW=CSRP validated for system origin privileges. 

CC=77B Validation for unlimited batch command processing. 

CM=34B Validation for a maximum of 163,700 words of central memory (CM). 
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MODVAL 
Parameters Validation or Permission 



NOTE 



This is the maximum amount of central memory 
anticipated to be required on a very large 
operating system (many products installed). 
Less field length may be required on smaller 
systems. If the user maximum CM validation 
is less than that indicated here, the 
installation job CML4 will dynamically 
determine the maximum amount available and 
request that amount. 



CS=4 Validation for a cumulative maximum of 10,000 PRUs of indirect access 
permanent file space. 

DB=7 Validation for an unlimited number of jobs to exist concurrently in 
system. 

DS=5 Validation for an individual direct access permanent file size of 50,000 
PRUs. 

FC=7 Validation for an unlimited number of permanent files. 

FS=6 Validation for a maximum indirect access permanent file size of 300 

PRUs. (The FS parameter should not be set equal to 7 as this may result 
in inefficient use of system resources.) 

LP=77B Validation for unlimited print output. 

MS=20B Validation for a maximum of 201,000 additional PRUs the user may 
allocate per job. 

MT=1 Validation for one magnetic tape unit. 

RP=1 Validation for one removable disk pack. [This validation is required 
only if REL1A (SYSOPL) is to be accessed and it resides on a removable 
device. ] 

SAV=CULT Validation to allow the user to write unlabeled magnetic tapes. 
Required only on NOS 2.2 and later versions. 

SAV=C0LD Validation to allow the user to use on-line diagnostics. 

SL=77B Validation for unlimited SRU accumulation. 

TL=7 Validation for 7100 (octal) seconds of CPU time. 
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RESOURCE REQUIREMENTS (NOS/BE) 



Magnetic Tape/ Permanent File Requirements 

The installation jobs require the magnetic tapes or their permanent file equivalents listed 
in table 1-2 to be available. All magnetic tape requests issued by the installation jobs 
contain a VSN parameter, which causes the requesting job to be rolled out until the request 
is satisfied. The tape requests can then be viewed via the P console display. All magnetic 
tapes can be mounted and the VSN assigned prior to the initiation of the installation 
process. 



Table 1-2. NOS/BE Installation Jobs Resource Requirements 



Magnetic 
Tape VSN 


Permanent 
File 


Used 
In Job 


Comments 


CMLVSN 

PL1B 


N/A 

User 
Defined 


CML1 
CML3 


CML Program Library. Tape must be 1600 bpi, labeled, 
with no Write Enable ring. Permanent file CMLPL is 
created from the Update Program Library (file 2) for 
use by subsequent installation jobs. Depending upon 
system configuration, various other files are copied 
from the tape and retained as permanent files. 

PL1B Program Library. Tape must be of VSN and 
density as specified by parameters OPLVSN and OPLDEN, 
respectively, with no Write Enable ring. A permanent 
file copy (random program library) is made of the 
tape and retained as permanent file 0PL1B under the 
IDENT specified by parameter CEID. This file may be 
purged when installation process is complete. 

Once permanent file 0PL1B is created, any rerun of 
CML3 will determine that the file alreay exists and 
will not request the tape again. 

If PL1B is available on disk, it may be used in lieu 
of the magnetic tape. It must be a random access 
program library file in Update format. The disk copy 
can be used by passing the permanent file name and 
IDENT in parameters OPLPFN and OPLUNID, respectively. 
If a password is required, it can be passed in 
parameter OPLPW. If the file resides on a private 
pack, the VSN and setname can be passed in parameters 
OPLPAK and OPLDTSET, respectively. 



Field Length and Mass Storage Requirements 

Execution of the installation jobs requires a maximum of 120,000 words of central memory and 
up to 7000 (octal) central processor unit (CPU) seconds depending on the specific CPU model 
in use. Sufficient mass storage space should be available as follows. 
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Temporary file space (released at job termination): 200,000 PRUs 

Permanent file space (released following installation): 200,000 PRUs 

Retained permanent file space (MALET diagnostics, and so on): 5000 PRUs 

These figures are estimates and may vary significantly depending on system configuration and 
specific parameters used during the installation process. The figures stated should be 
adequate for most installations. 

The installation process also requires the use of one magnetic tape transport. 



PREPARATORY PROCEDURES 

Perform the following preparatory procedures before installing CML. 

1. Gather Installation Materials. 

2. Read Documentation. 

3. Plan CML Installation. 

4. Create NOS or NOS/BE Job Deck. 

5. Perform Local Modifications/Corrections Code. 

Gather Installation Materials 

1. Locate the CML maintenance software kit provided by manufacturing for the applicable 
computer system. This kit contains a diagnostic software release bulletin (DSRB), a 
CML Program Library Tape, and documentation. 

2. For NOS, a REL1A tape, system deadstart tape, and a scratch tape (which is suitable 
for use as a new system deadstart tape) must also be available. For NOS/BE, a PL1B 
tape must also be available. 

Read Documentation 

1. Read the DSRB furnished in the CML kit. 

2. Read through the CML installation procedures later in this section. 

3. Read service bulletins. 

Plan CML Installation 

Following are step-by-step examples that may help simplify the planning process. The 
examples indicate how the various parameters are entered in the BEGIN statement. Refer to 
the detailed descriptions of parameters to determine the impact of each. (None of the 
parameters is carried forward in the examples. Parameters are shown only to illustrate the 
specific parameter format.) 
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Plan your CML installation using the following guidelines. 

EXAMPLE: 

1. Determine the desired hardware config- BEGIN, CMLINST.CMLTAPE, ,885, 67X.2550, 580, 800, 
uration and enter the required key- 
words in the BEGIN statement. 



If the internal sort feature of HPA 
must be used, add HPSORT; else, leave 
blank. 



BEGIN, CMLINST.CMLTAPE, 885, 67X, 2550, 580, 800, 
HPSORT, 



3. If running in an ECS/ESM-based multi- 
mainframe configuration, add MMF; 
else, leave blank. (NOS only.) 

4. If MALET mass storage access levels 
require modification, add N0TSECURE; 
else, leave blank. 

5. If 8.5-inch printer paper is in use, 
add PAPER85; if standard 11-inch 
paper is in use, leave blank. 

6. If the CML binaries are to be 
added to the running system, 
add SYSEDIT; else, leave blank. 

7. If 8 lines-per-inch print density 
is desired for MALET, add 8LPI; 
else, leave blank. 

8. If hardcopy documentation is de- 
sired for MALET diagnostics, specify 
the type in MALDOC. 

9. For NOS/ BE only, enter in parameter 
CEID the permanent file ident under 
which all permanent files are to be 
cataloged. 

10. If the system 0PL (RELIA for NOS, 

PL1B for N0S/BE) must be loaded from 
tape, specify the VSN and density in 
0PLVSN and OPLDEN. 



BEGIN, CMLINST.CMLTAPE, 885, 67X, 2550, 580, 800, 
MMF, 



BEGIN, CMLINST.CMLTAPE, 885, 67X, 2550, 580, 800, 
NOTSECURE, 



BEGIN, CMLINST.CMLTAPE, 885, 67X, 2550, 580, 800, 
PAPER85, 



BEGIN, CMLINST.CMLTAPE, 885, 67X, 2550, 580, 800, 
PAPER85, SYSEDIT, 



BEGIN, CMLINST.CMLTAPE, 885, 67X, 2550, 580, 800, 
PAPER85, SYSEDIT, 8LPI, 



BEGIN, CMLINST, CMLTAPE ,885 ,67X, 2550 ,580 ,800 , 
PAPER85 , SYSEDIT , 8LPI ,MALD0C=EXT , 



BEGIN, CMLINST, CMLTAPE, 885, 67X, 2550, 580, 800, 
PAPER85 , SYSEDIT ,8LPI ,MALD0C=EXT , CEID=CDCCE , 



BEGIN, CMLINST, CMLTAPE, 885, 67X, 2550, 580, 800, 
PAPER85 , SYSEDIT , 8LPI ,MALD0C=EXT , 
0PLVSN=REL1A, 0PLDEN=GE , 



11. If the system OPL is available on 
disk, specify the location using 
parameters OPLPAK, 0PLPFN, OPLPW, 
OPLUNID, and OPLDTSET. Omit any 
parameter not required. 

12. Enter the system version number in 
SYSVER. 



BEGIN, CMLINST, CMLTAPE, 885, 67X, 2550, 580, 800, 
P APER8 5 , SYSEDIT , 8LP I , MALDO C=EXT , 0PLPFN=0PL , 
OPLUNID=LIBRARY, 



BEGIN, CMLINST, CMLTAPE, 885, 67X, 2550, 
580, 800, PAPER85, SYSEDIT, 8LPI, 
MALD0C=EXT , 0PLPFN=0PL , 0PLUNID=LIBRARY , 
SYSVER=N0S6, 



1-12 



60455980 K 



EXAMPLE: 

13. Enter the required USER/CHANGE state- BEGIN, CMLINST, CMLTAPE, 885, 67X, 2550, 580,800, 
ment images. Under NOS/BE, accounting PAPER85, SYSEDIT, 8LPI,MALD0C=EXT,0PLPFN=0PL, 
information, if required, is passed 0PLUNID=LIBRARY,SYSVER=N0S6,USER-$USER, 
by the USER parameter and is incor- user, pass. $. 
porated into the installation jobs 
as the second control statement, 
right after the JOB statement. 
Additional accounting can be passed 
as the third statement in the 
installation job via the CHARGE 
parameter. 

At this point, the BEGIN statement is complete and can be incorporated into a card deck or 
job file as indicated in the sample NOS installation job. 

Create NOS or NOS/BE Job Deck 

The following NOS and NOS/BE sample jobs illustrate how to create installation jobs. While 
the examples show how this can be done using a card deck, it can also be done by creating a 
similar job or procedure interactively or by using 026 at the system console. 

NOS 

In this NOS example, the hardware configuration has been defined to include 844 and 885 disk 
drives, a 2550 communications controller, a 67X magnetic tape subsystem, 580 line printers, 
and a 405 card reader. The mainframe is also identified as a CYBER 170/180 Models 810, 815, 
825, 830, 835, 845, and 855 type (800 parameter). The software environment is defined as 
NOS 2.0 (N0S6 parameter). The operational environment is defined as using 8.5-inch printer 
paper, a SYSEDIT will be performed during the installation, and the user number, password, 
family, charge number, and project number have been supplied. The REL1A program library is 
available to the job on permanent file OPL under the user name LIBRARY. 

JOB,T200. 

-User/Charge statements- 
LABEL , CMLTAPE ,VSN=CMLVSN ,D=PE ,F=SI , P0=U. 
COPY BF , CMLTAPE , CMLPR0 C . 

BEGIN .CMLINST .CMLPROC , 844 , 885 , 2550 , 67X, 580 , 405 , 800 , 
PAPER85 , SYSEDIT , SYSVER=N0S6 , 
USER=$USER, 1 234567 , password ,FM. $ , 
CHARGE=$CHARGE, 7654321 ,CDC.$, 
0PLPFN=0PL ,0PLUNID=LIBRARY. 
ROUTE, CMLl,DC=IN.t 
6/7/8/9 

Example of how to initiate interactive install (INTINST). 

DEFINE, CMLPROC. 

LABEL .CMLTAPE ,F=SI ,P0=RU ,VSN=CMLVSN ,D=PE . 

C0PYBF , CMLTAPE , CMLPROC . 

-INTINST, CMLPROC. 



t If execution of the created installation jobs is not desired at this time, omit this 
statement. 
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INTERACTIVE EXECUTION 

The CML installation procedures can be executed interactively through use of the menu-driven 
procedure, INT1NST. When INTINST is executed, the user is presented with the menu shown in 
figure 1-3.1. 

• After the menu is presented, general information concerning execution of the 
procedures is obtained by entering a question mark, followed by a carriage return. 

• Information concerning any specfic procedure is obtained by appending a question 
mark to the number corresponding to the procedure, followed by a carriage return. 

• The desired function is selected by entering the corresponding number, followed by a 
carriage return. Then, the user is prompted for various parameters necessary to 
perform selected functions. 

• Local modifications/corrections code are utilized during updates. Refer to Perform 
Local/Modifications Corrections Code for file name. 

Help is available for all prompts and is obtained by entering a question mark, followed by a 
carriage return. 



CML INSTALLATION PROCEDURES 

1. BINARY INSTALL 

2. CML UTILITY INSTALLATION 

3. CML INSTALLATION INTERACTIVE 

4. ANALYZE EDD DUMP TAPE 

SELECT BY NUMBER AND PRESS NEXT 



Figure 1-3.1. INTINST MENU 

If a user wishes to bypass the menu presented by INTINST, each procedure can be called 
directly. 
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NOS/BE 

In this NOS/BE example, the hardware configuration has been defined to include 844 and 885 
disk drives, a 2550 communications controller, a 67X magnetic tape subsystem, 580 line 
printers, and a 405 card reader. The software environment is defined as NOS/BE 1.5 (N0SBE6 
parameter). The operational environment is defined as using 8.5-inch printer paper, a 
system EDITLIB will be performed (SYSEDIT parameter) during the installation, and job 
accounting information has been passed via the USER parameter. The PL1B program library is 
available to the job on permanent file PL1B, under the permanent file IDENT of INSTALL. 

JOB,T200,PE1. 

-Accounting Information- 
LABEL , CMLTAPE , VSN=CMLVSN , R , D=PE , X=IU , NORING . 
COPYBF , CMLTAPE , CMLPROC . 
REWIND, CMLPROC. 

BEGIN, CMLINST, CMLPROC, 844, 885, 2550, 67X, 580, 405, 800, 
PAPER85 , SYSEDIT , SYSVER=N0SBE6 , 
USER=$ACCOUNT ,1234567, password . $ , 
0PLPFN=PL1B , 0PLUNID= INSTALL . 
BEGIN , NEXT JOB , CMLINST , J0B=CML1 , CEID=CDCCE . t 
6/7/8/9 



NOTE 



Execution of the installation procedures and 
jobs requires that the procedures reside on 
permanent file CMLINST. The permanent file 
IDENT under which they are catalogued must 
be the same IDENT that is passed to the 
procedures via parameter CEID. If CEID is 
not specified, all permanent files created 
by the installation processes are catalogued 
using an IDENT of CDCCE. 



Perform Local Modifications/ Correction Code 

Local modifications or corrective code can be included in any of the assembled and/or 
compiled binaries. The modifications must be correction sets in Update fprmat and exist in 
permanent files (indirect access files on NOS) according to the following specifications. 
The files must reside under the user's user index (NOS) or the permanent file ident 
specified by CEID (NOS/BE). 



tlf execution of the created installation jobs is not desired at this time, omit this 
statement. 
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Modifications to 



Must Reside on 



CMLINST.CMSI 

MLD.SBP 

MALET 

HPA 

REGEN 

TIO 

SKEDULR 

MLTDOC 

MTPLOT 

MCCOMP 

MCDUMP 

DSPLOT 

DKDATA 



INSTMDS 
MLDMODS 
MALMODS 
HPAMODS 
REGMODS 
TIOMODS 
SKEDMDS 
MLTMODS 
MTPMODS 
MCCMODS 
MCDMODS 
DSPMODS 
DKDMODS 



(MALET diagnostics) 
ATC 
BCX 
COM 
CIU 
CLM 
CPE 
CP1 
CRE 
CRP 
CR1 
DFU 
DMA 
DTC 
DTI 
D44 

D88/DH8/DL8 
ELR 
FEP 
FFU 
FHC 
FLM 
FMC 

FMD/FHD/FLD 
FMU 
FSD 
FSM 
FTP 
F44 
F7X 
F88 
1ST 
ITU 
LCI 
LCM 
LCN 
LPE 
LP1 
MY8 
NIP 
NLM 
PDP 
RT3 



ATCMODS 
BCXMODS 
CCMMODS 
CIUMODS 
CLMMODS 
CPEMODS 
CP1MODS 
CREMODS 
CRPMODS 
CR1MODS 
DFUMODS 
DMAMODS 
DTCMODS 
DTIMODS 
D44MODS 
D88MODS 
ELRMODS 
FEPMODS 
FFUMODS 
FHCMODS 
FLMMODS 
FMCMODS 
FMDMODS 
FMUMODS 
FSDMODS 
FSMMODS 
FTPMODS 
F44MODS 
F7XMODS 
F88MODS 
ISTMODS 
ITUMODS 
LCIMODS 
LCMMODS 
LCNMODS 
LPEMODS 
LP1MODS 
MY8MODS 
NIPMODS 
NLMMODS 
PDPMODS 
RT3MODS 



(DH8 on NOS only) 



(FHD on NOS only) 
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Modifications to Must Reside on 

RT5 RT5M0DS 

TFE TFEMODS 

TFF TFFMODS 

TFL TFLMODS 

TT3 TT3MODS 

T5X T5XM0DS 

T6X T6XMODS 

T7X T7XM0DS 



CML INSTALLATION PROCEDURES 

1. Mount CML tape. 



2. Initiate your NOS or NOS/BE job using a card deck or interactively through a 

terminal. The ROUTE statement starts execution of the first installation job. The 
remaining jobs are routed at the proper time in sequence. 

After execution of one of these jobs is accomplished, all that is required is to mount and 
assign magnetic tapes, and to enter a GO if a SYSEDIT (EDITLIB) is to be performed. 

Should errors occur during the execution of any of the installation jobs, the sequence can 
be restarted by manually routing to the input queue the job that failed. Care must be taken 
when restarting any job due to job interdependencies. If in doubt, it is recommended that 
the entire sequence be restarted. Note that the program libraries REL1A or PL1B are saved 
as permanent files by the jobs. Once they have been successfully loaded from tape, a 
restart of the job will use the permanent files In lieu of reloading them from tape. 



CML Installation Notes (NOS) 

If a new deadstart tape is not desired, job CML4 may be dropped after the old deadstart tape 
(VSN=OLDDST) has been requested. All remaining CML Installation processes will have been 
initiated prior to this tape request. If the new deadstart tape is not created by CML4, it 
must be built through a user-supplied process that incorporates the routines contained on 
permanent files CMLBIN and MLDBIN. 

The LIBEDIT directives used to build the new deadstart tape delete groups of records by 
using the from/to directive format. This requires the CML-related records on the old 
deadstart tape to be in contiguous blocks. Users are cautioned that adding nonstandard 
records into these blocks or rearranging the CML-related records on the deadstart tape could 
result In creation of an invalid new deadstart tape. Always review the list output of jobs 
CML2, CML3, and CML4 to verify that no non-CML -related records were deleted. 

The CML installation job that creates the MALET diagnostics does not carry the MALET source 
code with the module binaries. Source code is not generally required for normal maintenance 
activities and it can waste permanent file space. Use the CML installation utility MALDIAG 
to compile any diagnostics for which source code is to be carried with the module binary. 

The CML installation process replaces all existing copies of MALET diagnostics with the new 
versions. These new versions may not execute properly if used with the older version of 
MALET. Should the new version of CML not be implemented immediately, the customer engineer 
may be without any executable MALET diagnostics. In this situation, it is best to install 
CML using another username, then move the new MALET diagnostics to the old username when the 
new CML is implemented. 
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CML Installation Notes (NOS/BE) 

The CML installation process purges the latest cycle of the MALET diagnostics before 
cataloging the new version of the diagnostic. These new versions may not execute properly 
if used with the older version of MALET. If the new version of CML is not implemented 
immediately, the customer engineer may be without any executable MALET diagnostics. In this 
situation, it is best to install CML using another permanent file ident, then purge the old 
diagnostics and change the ident of the new diagnostics when the new CML is implemented. 
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POST-INSTALLATION PROCEDURES 

Permanent File Cleanup 

The following permanent files may be purged after CML Installation is complete. 

CMLPL 

DIAGLIB 

SYSOPL (NOS only) 

0PL1B (NOS/BE only) 

CML1 

CML 2 

CML 3 

CML4 

CML5 

CML 6 



INSTALLATION PARAMETERS 

Parameter Formats 

The parameters passed to the procedures already discussed must conform to the specific 
formats as follows. 



Format 



keyword 



keyword=value 



keyword=$value$ 



Applies to 
All hardware configuration parameters 



HP SORT 

MMF 

NOTSECURE 

PAPER85 

SYSEDIT 

8LPI 

MALDOC 

OPLDEN 

OPLPAK 

OPLPFN 

OPLPW 

OPLUNID 

OPLVSN 

SYSVER 

CEID 

OPLDTSET 

CHARGE 
USER 



(NOS only) 



(NOS/BE only) 
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Hardware Configuration Parameters 

Table 1-3 Includes a description of the hardware configuration parameters used in the 
procedures discussed earlier in this section. 



Table 1-3. Hardware Configuration Parameters (Sheet 1 of 4) 



Parameter 
Name 


Used 
In Job 


Function 


CYBERPLUS 
(NOS only) 


CML5 


Specifies that CYBERPLUS hardware is included in the 
configuration. Causes MALET diagnostic CRP to be 
compiled. 


DEMA (NOS only) 


CML2, CML5 

DEM/ 


Specifies that DEMA hardware is included in the 
configuration. Causes MALET diagnostics FHD, FHC, 
DH8, FEP, and FMU to be compiled. Also causes 885 
detailed status analysis tables to be included in HPA. 




NOTE 




i is not 


support 


ed on NOS /BE. 


ESM 


CML5 


Specifies that ESM hardware is included in the 
configuration. If SYSVER is N0S4 , N0S5, or N0SBE6, 
causes MALET diagnostic ELR to be compiled. 


FSCDISK 


CML1, CML5 


Specifies that a Federal Standard Channel driving 
disks is included in the configuration. Causes MALET 
diagnostics F44, F88, FLM, and FFU to be compiled. 
Also, NAD diagnostics NDM and NDP are loaded from the 
CML tape and saved by CMLl . 


FSCTAPE 


CML1, CML5 


Specifies that a Federal Standard Channel driving tape 
drives is included in the configuration. Causes MALET 
diagnostics F7X, FLM, and FSM to be compiled. Also, 
NAD diagnostics NDM and NDP are loaded from the CML 
tape and saved by CMLl . 


LCN 


CMLl, CML5 


Specifies that LCN is included in the hardware 
configuration. Causes MALET diagnostics LCI, LCN, 
LCM, and NLM to be compiled. Also causes CMLl to load 
NDM, NDP, and NDT from the CML tape and save them. 


PLATO 
(NOS only) 


CML5 


Specifies that the system is running PLATO and causes 
MALET diagnostic CIU to be compiled. 


MASSTOR 


CMLl, CML5 


Specifies that a CYBER Channel Coupler and MASSTOR are 
included in the configuration. Causes MALET 
diagnostics CCM and CLM to be compiled. Also, NAD 
diagnostics NDM and NDP are loaded from the CML tape 
and saved by CMLl. 
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Table 1-3. Hardware Configuration Parameters (Sheet 2 of 4) 



Parameter 
Name 


Used 
In Job 


Function 


UNIBUS 


CML5 


Specifies that a CYBER/UNIBUS interface and DEC PDP11 
are included in the configuration. Causes MALET 
diagnostic PDP to be compiled. 


405 


CMLl, CML5 


Specifies that a 405 card reader is included in the 
configuration. Causes MALET diagnostics CRE and CR1 
to be compiled. Also causes CMLl to load and save 
CR1SCR from the CML tape. 


415 


CML5 


Specifies that a 415 card punch is included in the 
configuration. Causes MALET diagnostics CPE and CP1 
to be compiled. 


512 


CML5 


Specifies that a 512 line printer is included in the 
configuration. Causes MALET diagnostics LPE and LP1 
to be compiled. 


580 


CML5 


Specifies that a 580 line printer is included in the 
configuration. Causes MALET diagnostics FTP and LPE 
to be compiled. 


639 (NOS only) 


CML5 


Specifies that a 639 magnetic tape subsystem is 
included in the system configuration. Causes MALET 
diagnostic 1ST and utility ITU to be loaded and saved. 


65X 


CML5 


Specifies that a 60X or 65X magnetic tape subsystem is 
included in the configuration. Causes MALET 
diagnostic T5X to be compiled. 


66X 


CMLl, CML2, 
CML5 


Specifies that a 66X magnetic tape subsystem is 
included in the configuration. Causes the MALET 
diagnostics T6X, BCX, and MY8 to be compiled. Also, 
causes BCXBC and MY8BC to be loaded from the CML tape 
and saved by CMLl. Also causes the detail status 
analysis tables for 66X to be included in HPA. 


67X 


CML5 


Specifies that a 67X magnetic tape subsystem is 
included in the configuration. Causes MALET 
diagnostics T7X and ATC to be compiled. Also causes 
the detail status analysis tables for 67X to be 
included in HPA. 


698 


CML1.CML5 


Specifies that 698 tape drives and a CYBER Channel 
Coupler are included in the configuration. Causes 
MALET diagnostics T7X, CCM, and CLM to be compiled. 
Also, NAD diagnostics NDM and NDP are loaded from the 
CML tape and saved by CMLl . 


800 


CML6 


Specifies that a CYBER 170-800 computer system (except 
models 865 and 875) is included in the configuration. 
Causes microcode utilities MCDUMP and MCCOMP to be 
compiled and retained as permanent files. 
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Table 1-3. Hardware Configuration Parameters (Sheet 3 of 4) 



Parameter 
Name 



Used 
In Job 



Function 



83X (NOS only) 



844 



CML5 



CML2, CML5 



885 



885LS 
(NOS only) 



CML2, CML5 



CML5 



895 



CML1, CML5 



2550 



CML1, CML5 



2550100 



5X70 



CML5 



CML1, CML5 



667X 



7X54 



CML5 



CML1, CML5 



Specifies that 834 (ISD1) or 836 (ISD2) disk drives 
are included in the configuration. Causes MALET 
diagnostics FSD and DFU to be compiled. 

Specifies that 844 disk drives are included in the 
configuration. Causes the MALET diagnostic D44 to be 
compiled. If 7155 is also defined, MALET diagnostic 
DTC is also compiled. Also causes the detail analysis 
tables for 844s to be included in HPA. 

Specifies that 885 disk drives are included in the 
configuration. Causes MALET diagnostics D88, FMC, 
FMD, and FMU to be compiled. Also causes the detail 
status analysis tables for 885s to be included in HPA. 

Specifies that large sector 885 disk drives are 
included in the system configuration. Causes MALET 
diagnostics FLD and DL8 to be loaded and compiled. 
Will also cause FMC and FMU to be loaded and compiled 
if not done through the inclusion of other hardware 
parameters . 

Specifies that an 895 disk and a CYBER Channel Coupler 
are included in the configuration. Causes MALET 
diagnostics DFU, DTI, CCM, and CLM to be compiled. 
Also, NAD diagnostics NDM and NDP are loaded from the 
CML and saved by CML1. 

Specifies that a 2550 communications controller is 
included in the configuration. Causes MALET 
diagnostics TFF and TFL to be compiled. Also, the ODS 
diagnostics will be loaded from the CML tape and saved 
by CML1. 

Specifies that a 2550-100 communications controller is 
included in the configuration. Causes MALET 
diagnostic TFE to be compiled. 

Specifies that a CYBER Channel Coupler and 5870 or 
5970 Nonimpact Printer are included in the 
configuration. Causes MALET diagnostics NIP, CCM, and 
CLM to be compiled. Also NAD diagnostics NDM and NDP 
are loaded from the CML tape and are saved by CML1. 

Specifies that either a 6671, 6673, 6674, or 6676 
multiplexer is included in the configuration. Causes 
MALET diagnostics TT3 and RT5 to be compiled. 

Specifies that either a 7054, 7154, or 7152 controller 
is included in the configuration. Causes MALET 
diagnostics BCX and MY8 to be compiled. Also, BCXBC 
and MY8BC will be loaded from the CML tape and saved 
by CML1. 
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Table 1-3. Hardware Configuration Parameters (Sheet 4 of 4) 



Parameter 
Name 



7155 



7155C 



Used 
In Job 



CML5 



CML5 



Function 



Specifies that a 7155 disk controller is included in 
the configuration. This parameter is only required 
when the 844 disk drives are connected to the 7155 
controller. If both 844 and 7155 are defined, MALET 
diagnostic DTC will be compiled in addition to FMD, 
FMC, and FMU. 

Specifies that a 7155C disk controller is included in 
the configuration. This parameter is required when a 
7155C type controller is used and DEMA is not defined. 
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Software/Operational Environment Parameters 

Table 1-4 includes descriptions of the software /operational environment parameters used in 
the procedures discussed earlier in this section. 



Table 1-4. Software/Operational Environment Parameters (Sheet 1 of 3) 



Parameter 

Name 


Used 
In Job 


Function 


CEID (NOS/BE 
only) 


ALL 


The NOS/BE permanent file IDENT under which all 
permanent files are to be catalogued. 


CHARGE 


CMLl, CML2, 
CML3, CML4, 
CML5, CML5A, 
CML6 


Charge statement image. Parameter must be passed as 
a literal (enclosed in $ $). Parameter required 
only if system requires charge numbers. 

Default: COMMENT. -NO CHARGE NUMBER SUPPLIED- 


HPSORT 


CML2 


Keyword passed to evoke the internal HPA sort routine 
in lieu of SORT/MERGE 5. 

Omitted: HPA calls SORT /MERGE 5 to sort the data. 
Specified: HPA calls the internal routines to sort 
the data. 


MALDOC 


CML5, CML5A 


Type of hardcopy documentation desired for compiled 
MALET diagnostics. 

Legal values: 

NONE (No documentation produced; default). 

EXT (External documentation produced). 

INT (Internal documentation produced). 

BOTH (Both internal and external documentation 

produced). 


MMF (NOS only) 


CML6 


Keyword passed to cause SKEDULR to be assembled for 
use in a multimainf rame environment. (Used in NOS 
only. ) 

Default: SKEDULR assembled for use in single or 
nonshared mainframe environment. 


NOT SECURE 


CML3 


Keyword passed to evoke a *YANK, SECURE directive 
during the Update of MLD. This alters the MALET mass 
storage access level capabilities. 

Omitted: *DEFINE, SECURE (recommended). 
Specified: *YANK, SECURE (not recommended). 
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Table 1-4. Software/Operational Environment Parameters (Sheet 2 of 3) 



Parameter 


Used 




Name 


In Job 


Function 


PAPERS 5 


CML2 


Keyword passed to cause MALET to be assembled for use 
with 212.5 mm (8.5 In) printer paper. 

Omitted: MALET assembled for use with standard 
279.4 mm (11 in) printer paper. 


OPLPAK=pack 


CML2, CML3 


Removable pack on which system OPL [RELIA (NOS) 

or PL1B (NOS/BE)] resides. Parameter not required if 

file is on nonremovable device . 

Omitted: System OPL on nonremovable device. 


OPLPFN=opl 


CML2, CML3 


Permanent file name of system OPL [RELIA (NOS) or 
PL1B (NOS/BE)] if file exists. If passed, specified 
file is used. Parameters OPLUNID, OPLPAK, OPLDTSET, 
and OPLPW are used if specified. If OPLPFN Is omitted, 
system OPL is loaded from tape and retained as 
permanent file. For NOS, RELIA is retained on direct 
access permanent file In user index. For NOS/BE, PL1B 
is retained on permanent file OPLIB under Ident 
specified by CEID. 


OPLPW=password 


CML2, CML3 


Password used for read access to OPLPFN. Parameter 
required only when no password is given. 


OPLUNlD=unid 


CML2, CML3 


User number (NOS) or permanent file Ident (NOS/BE) of 
permanent file name passed in OPLPFN. 

Default: LIBRARY (NOS). 

No default for NOS/BE. 


OPLVSN=vsn 


CML2, CML3 


The VSN of RELIA (NOS) or PL1B (NOS/BE) magnetic 
tape program library. Parameter not required when 
permanent file name passed in OPLPFN. 

Default: RELIA (NOS). 

PL1B (NOS/BE). 


: SYSEDIT 


CML4, CML5, 


Keyword specified if SYSEDIT (NOS) or EDITLIB 




CML5A 


(NOS/BE) is performed by CML4. If not specified, 
CML4 creates permanent file copy of compiler for use 
by jobs created by CML5A. If keyword not specified, 
CML5A uses MALET from system library after SYSEDIT 
(EDITLIB) performed. 


OPLDEN=dn 


CML2, CML3 


Density of RELIA (NOS) or PL1B (NOS/BE) magnetic tape. 

Legal values for dn: 

GE (9-track GCR) . 

PE (9-track phase). 

HD (9-track NRZI). 

HY (7-track NRZI, 800-bpi). 
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Table 1-4. Software/Operational Environment Parameters (Sheet 3 of 3) 



Parameter 
Name 



OPLDTSET=Device 
Type 
=Setname 



SYSVER=ver 



Used 
In Job 



Function 



CML, CML3 



CML2, CML3, 
CML5, CML6 



USER 



8LPI 



CML1, CML2, 
CML3, CML4, 
CML5, CML5A, 
CML 6 



CML 2 



The device type (NOS) or setname (NOS/BE) on which 
the system OPL resides. This parameter Is required 
only if the file specified by OPLPFN resides on a 
private pack (NOS) or a pack other than the default 
set (NOS/BE). 

Legal values for device type: 



DB 
DC 
DD 



DG 
DI 
DJ 



DK 
DL 
DM 



DQ 
DV 
DW 



System version number. Used by CML2 
and CML3 in assembly of MLD, SBP, and 
MALET. Used by CML6 in NOS to assemble 
SKEDULR. Used by CML5 to determine the 
need for MALET diagnostic, ELR. 

Default: None (this is a required parameter). 

Legal values for ver: 



N0S25 


(NOS 2.5). 


NOS24 


(NOS 2.4). 


NOS23 


(NOS 2.3). 


N0S6 


(NOS 2.0,2.1,2.2). 


N0S5 


(NOS 1.4). 


N0S4 


(NOS 1.3). 



N0SBE6 (NOS/BE 1.5). 
NOSBE5 (NOS/BE 1.4). 
N0SBE4 (NOS/BE 1.3). 

User statement image (NOS) or first line of accounting 
information (NOS/BE). Parameter must be passed as a 
literal (enclosed in $...$) and is required in NOS 
unless the created jobs are manually modified to 
include SUI statements in the job stream. In NOS/BE, 
the parameter is required only if accounting 
information is required by the installation. 

Omitted: COMMENT. - NO USER NUMBER SUPPLIED - 

Keyword passed to cause MALET to be assembled to use a 
print density of 8 lines per inch. If not specified, 
means MALET assembled for print density of 6 lines per 
inch. 
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CML INSTALLATION JOBS DESCRIPTIONS (CML1 THROUGH CML6) 

The following are brief descriptions of the functions performed by each of the CML 
installation jobs (CML1 through CML6): 



CML1 



Creates a library format permanent file containing CMLINST and CMSI (NOS only). 

- Creates a random program library (PL) on disk from the sequential PL contained 
on file 2 of the CML release tape. 

Loads MALET scratch file binaries and utility programs as needed to support the 
configuration defined. 

Loads a file of MALET diagnostic binaries for subsequent use by the jobs 
submitted by job CML5 (NOS only). 



CML 2 



Assembles/compiles MALET, HPA, REGEN, and TIO, and retains the binaries on 
permanent file CMLBIN. 



CML 3 



- Assembles MALET PPU routines MLD and SBP, and retains the binaries on permanent 
file MLDBIN. 



CML4 



Performs an optional system edit (SYSEDIT on NOS; EDITLIB on NOS/BE), 
incorporating the binaries generated by jobs CML2 and CML3. 

Generates a new deadstart tape (NOS only), incorporating the binaries generated 
by jobs CML2 and CML3. 

CML 5 

- Routes jobs to input that will load/compile all MALET diagnostics necessary to 
support the defined configuration. 

CML5A (One job is generated for each MALET diagnostic.) 

- Loads/compiles one MALET diagnostic and retains the binary as a permanent file. 

- Generates any requested hardcopy documentation for MALET diagnostics. 

CML 6 

Assembles/compiles SKEDULR, MLTDOC, and MTPLOT and retains the binaries on 
permanent files. 

On 800 series systems (except 865/875), compiles microcode utilities MCCOMP and 
MCDUMP and retains them as permanent files. 
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BINARY INSTALLATION 

Portions of CML can be installed from the CML Release Tape in binary form. Binary 
installation is intended to be used in conjunction with the NOS-tailored release process. 

Binary installation involves loading from the CML Release Tape those MALET diagnostics, 
MALET scratch file binaries, and any other maintenance utilities necessary to support a 
specific hardware configuration. 

The major benefits realized through the binary installation process include: 

1. A significant reduction is achieved in the time required to attain an operational 
concurrent maintenance capability. 

2. CML capabilities will be available to facilitate checkout of new system installations. 

3. The most current version of CML will be included with each new operating system release. 



NOTE 



For users who have a signed maintenance 
services agreement with Control Data, those 
components of CML that reside on the operat- 
ing system library will be included on the 
tailored deadstart tape. The source program 
libraries, installation decks, and any other 
files that are required to install and 
support the CML product are contained on the 
permanent file tape(s) delivered with the 
operating system. 



The format of the CML files contained on the permanent file dump tape(s) is identical to 
that of the standard CML Release Tape. Therefore, binary installation can be performed from 
either medium. If the CML Release Tape is used (in lieu of the CML file contained on 
the system permanent file dump tapes), it MUST be at the same PSR level as the CML binaries 
contained on the tailored deadstart tape. 

The NOS-tailored release process includes creation of a default username intended for use by 
the customer engineer for maintenance purposes, and to complete installation of the CML 
product. This default username/password is: 

Username Password 

CDCCE CDCCE 
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If desired, a different username/password may be created for these purposes in lieu of the 
default. 



NOTE 



If the default username is used, it is 
important to change the password prior to 
placing the system into a production 
environment. If another username/password 
is to be used for maintenance purposes, the 
default username should be eliminated after 
installation is complete. These precautions 
will help ensure that unauthorized access to 
the system does not occur. 



Part of the system installation process is to load the CML file from the permanent file dump 
tape(s) to disk in preparation for the CML binary install process. The file will be 
retained as t 

PFN = CML3 
UN = CDCCE 

Binary installation is accomplished using the installation procedure BININST. This 
procedure is contained on the first file of the CML Release Tape. BININST is written in the 
CYBER Control Language (CCL) and is designed to be executed via an interactive terminal. 
Should an interactive terminal not be available, BININST can be executed as a batch job or 
from the system console. 

Installation time will vary depending on the specific hardware configuration and the 
installation medium used, but it should not exceed 15 minutes. When installation is 
complete, permanent file CML3 should be purged. 



INTERACTIVE MODE 

Binary installation of CML can be performed interactively by using the following procedure: 

1. Login to the system through the Interactive Facility (IAF) or through the Remote 
Diagnostic Facility (RDF). Use either the default username/password or other 
username created for use by the customer engineer. 



NOTE 



If a username other than the default is to 
be used to complete CML installation, ensure 
that the username has been granted read 
permission to the CML3 permanent file. 
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2. Access the CML3 permanent file, or request the CML Release Tape: 

ATTACH, CMLTAPE=CML3/UN=CDCCE. (If using CML3 file) 

or 
LABEL, CMLTAPE, VSN=CMLVSN,F=S I. (If using CML Release Tape) 
The local file name must he CMLTAPE. 

3. Copy the first file, which contains the installation procedures, to a local file 
named PROCFIL: 

COPYBF , CMLTAPE , PROCF IL . 

4. Call the procedure BININST into execution: 

BEGIN, BININST? 

Be sure to append the question mark (?) to the procedure name, as this evokes CCL 
interactive prompting. 

5. You will now he prompted for the equipments contained in the configuration. 

a) To indicate the presence of a device, respond with a Y, followed hy a carriage 
return. 

b) To indicate the absence of a device, respond with a null line (carriage return 
only), or an N followed by a carriage return. 

c) To obtain a more detailed description of a device, enter a question mark (?) 
followed by a carriage return. A brief description of the device will be 
presented, followed by a repeat of the prompt message. 

6. After all questions have been answered, the installation process will commence. 
Brief messages are output to the terminal during execution to keep the user informed 
of the installation progress. 

7. When the installation process is complete, all MALET diagnostic binaries, MALET 
scratch file binaries, and any other maintenance utilities required to support the 
defined configuration will be retained as permanent files in the user's catalog. 

BATCH MODE 

To perform installation in batch mode, create a job of the following format and route it to 
the input queue using the most convenient means. 

CML JOB. 

USER, username, pas sword, familyname. 

CHARGE, chargenumber, pro jectnumber. (if required) 

ATTACH, CMLTAPE=CML3 /UN =CDCCE. (if using CML3 file) 

or 
LABEL,CMLTAPE,VSN=CMLVSN,F=SI. (if using CML Release Tape) 
COPYBF , CMLTAPE , PROCFIL. 
BEGIN, BININST,, eql,eq2,...,eqi. 
6/7/8/9 (EOI) 

This mode of execution requires that the configuration parameters be passed in the BEGIN 
statement. Refer to table 1-3, Hardware Configuration Parameters, for a description of 
valid parameters. 
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FROM THE SYSTEM CONSOLE 

Installation can be performed from the system console by using the batch method described 
earlier, or by executing the procedure directly. Either method requires use of DIS and the 
026 File Editor utility. DIS and 026 are documented in section 1, Console Commands, of the 
NOS Version 2 Systems Programmer's Instant. The user should be familiar with these 
utilities before attempting installation from the system console. 

To perform the installation in batch mode, use 026 to create a job, as already shown under 
Batch Mode, then route the job to the input queue. 

To execute the procedure directly from the system console, it is best to create a second 
procedure, as follows, which will then call BININST: 

1. Enter DIS. Then enter the desired usernarae/password. 

2. Using 026, create the following procedure and write it to file MYPROC. 

.PR0C.MYPR0C. 

ATTACH, CMLTAPE=CML3/UN=CDCCE. (if using CML3 file) 

or 
LABEL, CMLTAPE,VSN=CMLVSN,F=SI. (if using CML Release Tape) 
COPYBF , CMLTAPE , PROCFIL. 
BEGIN, BININST,, eql,eq2 eqi.t 

3. Under DIS enter: 

BEGIN, , MYPROC. 

4. The procedure now runs similar to interactive mode, except that interactive 
prompting is not available. The hardware configuration must be passed in the BEGIN 
statement. 

Progress of the installation can be determined by monitoring the job dayfile. 

5. When installation is complete, drop DIS. 



CML INSTALLATION UTILITIES 

In addition to the standard CML installation procedures, a set of CML installation utilites 
is provided to the NOS user. These utilities are applicable to NOS 2.1, Level 580 and later 
versions. These utilities are not applicable to NOS /BE or NOS 1.x. 

The utilities are not intended to replace the standard CML installation procedures. Full 
CML installation should be accomplished using the standard installation procedures. The 
utilities should be used in those situations where changes must be made to individual CML 
components , and when it is not desirable to perform a complete reinstallation of CML. 

The utilities are included in file CMLINST, which is created during CML installation. 
CMLINST should be retained as a permanent file following installation so that access to the 
utilities is readily available. 



tThis statement may exceed one line image; if so, the first line must end in a separator. 
Table 1-3 contains valid hardware configuration parameters for eqi. 



1-28 60455980 N 



The utilities provide the following capabilltes. 

Compile MALET diagnostic. 

Generate MALET diagnostic documentation. 

Compile HPA. 

Assemble MALET. 

Assemble MLD and SBP. 

Compile REGEN or TIO. 

Assemble SKEDULR. 

Compile MCCOMP, MCDUMP , MLTDOC, or MTPLOT. 

Load MALET scratch file binaries from CML release tape. 

Perform SYSEDIT of the running operating system, incorporating binaries contained on 
permanent files MLDBIN and CMLBIN. 

Generate new deadstart tape, incorporating binaries contained on permanent files 
MLDBIN and CMLBIN. 



EXECUTION MODES 

The installation utilities are designed for execution primarily from an interactive 
terminal, although they can be executed from a batch job. 



INTERACTIVE EXECUTION 

The utilities can be executed interactively through use of the menu-driven procedure , 
CMLUTIL. When CMLUTIL is executed, the user is presented with the menu shown in figure 1-4. 

• After the menu is presented, general information concerning execution of the 
utilities is obtained by entering a question mark, followed by a carriage return. 

• Information concerning any specific utility is obtained by appending a question mark 
to the number corresponding to the utility, followed by a carriage return. 

• The desired function is selected by entering the corresponding number followed by a 
carriage return. Then, user is prompted for various parameters necessary to perform 
selected functions. 

• Local modifications/corrections code are utilized during updates. Refer to Perform 
Local Modifications /Corrections Code for file names. 

Help is available for all prompts and is obtained by entering a question mark, followed by a 
carriage return. 
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CML 


INSTALLATION UTILITIES 


1. 


COMPILE MALET DIAGNOSTIC 


2. 


GENERATE MALET 0IAGNOSTC DOCUMENTATION 


3. 


COMPILE HPA 


4. 


ASSEMBLE MALET 


5. 


ASSEMBLE MLD AND SBP 


6. 


COMPILE REGEN OR TIO 


7. 


ASSEMBLE SKEDULR 


8. 


COMPILE MCCOMP, MCDUMP, MLTDOC OR MTPLOT 


9. 


LOAD MALET SCRATCH FILE BINARIES 


10. 


LOAD CML PROGRAM LIBRARY 


11. 


SYSEDIT THE OPERATING SYSTEM 


12. 


GENERATE NEW DEADSTART TAPE 


SELECT BY NUMBER OR TYPE Q TO QUIT ? 



Figure 1-4. CMLUTIL Menu 



If a user wishes to bypass the menu presented by CMLUTIL, each utility can be called 
directly. Refer to table 1-5 for the name of each utility and the corresponding menu 
selection number. 

When executing the utilities from an interactive terminal, the user is asked if the 
execution is to be accomplished in BATCH or INTERACTIVE mode. If BATCH mode is selected, 
the user is prompted for user and charge numbers, which must be enclosed with dollar sign 
delimiters as $user,pw,fm$, and for output listing disposition. A job is then created and 
routed to the input queue to perform the selected function. This mode of execution frees 
the terminal and allows several different utilities to be in execution simultaneously. It 
is best suited for long, time-consuming tasks. 

If the interactive mode of execution is selected, the utility is executed in the true 
interactive mode. Most utilities issue informative messages to the user so that progress 
can be monitored. In this mode, another utility cannot be started until the current one has 
completed. True interactive mode is best for single, quickly completed functions. 
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Table 1-5. Installation Utilities And Functions 



CMLUTIL 

Selection 

Number 


Procedure 
Called 


Procedure Function 


1 


MALDIAG 


Compile one MALET diagnostic and retain binary as a permanent 
file. 


2 


MALDOC 


Generate documentation for one MALET diagnostic. 


3 


HPACOMP 


Compile HPA. If execution is to be from a local file, retain 
binary on permanent file HP. If execution is to be from system 
library, include binary on file CMLBIN. 


4 


MALASSY 


Assemble MALET compiler/executive and include binary on file 
CMLBIN . 


5 


MLDSBP 


Assemble MALET PPU routines MLD and SBP and retain binaries on 
file MLDBIN. 


6 


REGTIO 


Compile REGEN or TIO. Retain binary as a permanent file for 
execution from a local file, and also include binary on file 
CMLBIN. 


7 


SKDASSY 


Assemble CML utility, SKEDULR, and retain binary on a permanent 
file. 


8 


UTLCOMP 


Compile CML utility MCCOMP, MCDUMP, MLTDOC, or MTPLOT and retain 
binary on a permanent file. 


9 


BINLOAD 


Load selected MALET scratch file binaries from CML release tape 
and retain as permanent files. 


10 


CMLLOAD 


Load CML program library to disk and retain as permanent file 
CMLPL. 


11 


SYSEDIT 


SYSEDIT running system, incorporating binaries contained on 
files CMLBIN and/or MLDBIN. 


12 


SYSTAPE 


Generate new deadstart tape, incorporating binaries contained on 
files CMLBIN and/or MLDBIN. 
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BATCH JOB EXECUTION 

If it is not convenient to execute the utilities via an interactive terminal, they can be 
called from a batch job. In this case, all required parameters must be passed to the 
utility by including them on the associated BEGIN statement. Table 1-6 contains a list of 
the utilities and associated parameters. Any output listings generated are contained on 
file OUTPUT. Disposition of output is implicit and depends upon the mechanism used to enter 
the job into the system. The ROUTE statement (see the NOS Reference Set, Volume 3) can be 
used to override implicit routing. Figure 1-5 shows a sample batch job which uses the 
utilities. 

Local modifications/corrections code are utilized during updates. Refer to Peform Local 
Modifications /Corrections Code for file names. 

All parameters passed in the BEGIN statement must be in the form as shown in figure 1-5. 



Keyword=option . 

CML JOB . 

USER , USERNAME , PASSWORD , FAMILYNAME . 

BEGIN .MALDIAG ,CMLINST ,DIAG=FMC ,LISTOPT=S . 

BEGIN .MALDOC , CMLINST ,UTILITY=MCCOMP,LISTING=YES . 

6/7/8/9 



Figure 1-5. Sample Batch Job 



SYSOPL (REL1A) 

Three of the installation utilities require access to the system OPL (REL1A) for proper 
execution; MALASSY, MLDSBP, and SKDASSY. These utilities use supplemental procedures 
(contained on CMLINST) to gain access to this file. When one of these utilities is 
executed, the user must have either previously gained access to the files, or must provide 
the utility with the location of the file. The location of the system OPL is passed through 
the following parameters: 

OPLPFN OPLUNID OPLPW OPLPAK 
OPLDTSET OPLVSN OPLDEN 

Legal values for these parameters are described in table 1-4. 

Following is the sequence the utilities use to gain access to the file. The process 
continues until one of the actions is satisfied. 

• When using an interactive terminal: 

- Check for a local file with the name OPL. 

- Check for a local file with the name OPLDIR; it contains directives which, when 
executed, access the file. 

- Prompt user for location of file. Either attach file or load it from tape, 
depending on response of user to prompts . 
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• When running from a batch job (as in figure 1-5): 

- Check to see if file OPL is local. 

- Use permanent file parameters passed in BEGIN statement to access file. (OPLPFN, 
OPLUNID, OPLPW, OPLPAK, OPLDTSET) 

- If no permanent file parameters were passed, use permanent file SYSOPL if it 
exists in index of user. 

- If SYSOPL is not in index of user, load it from tape and retain it as SYSOPL 
under index of user and use values passed in OPLVSN and OPLDEN. If none were 
passed, use a VSN of REL1A. 

The following examples illustrate how a batch job can be structured to gain access to system 
OPL: 

JOB . . . 

USER. . . 

ATTACH , OPL/ UN=LIBRARY . 

BEGIN .MALASSY , CMLINST , SYSVER=N0S2 3 . 

BEGIN .MLDSBP , CMLINST , SYSVER=NOS23 . 



JOB . . . 

USER. . . 

BEGIN .MALASSY , CMLINST ,SYSVER=NOS 23 , OPLPFN=OPL , 

OPLUNID=LIBRARY . 

BEGIN .MLDSBP , CMLINST , SYSVER=NOS 23 . 



Once file OPL is local to the job, it remains assigned until job termination. 



Table 1-6. Batch Job Parameters (Sheet 1 of 7) 



Procedure 


Parameter 


Function 


BINLOAD 


CR1 

LCN 


Loads CR1SCR to disk. 
Legal Values: 

Yes - Load CR1SCR to disk. 
No or omitted - Do not load CR1SCR. 
Loads LCN tests to disk. 
Legal Values: 

Yes - Load LCN tests NDM, NEP, and NDT to disk. 
No or omitted - Do not load LCN tests. 



60455980 M 



1-33 



Table 1-6. Batch Job Parameters (Sheet 2 of 7) 



Procedure 


Parameter 


Function 




MY8BCX 


Loads MY8BC and BCXBC to disk. 
Legal Values: 

Yes - Load MY8BC and BCXBC to disk. 

No or omitted - Do not load diagnostics. 




ODS 


Loads 255X/ODS diagnostics to disk. 
Legal Values: 

Yes - Load 255X/ODS diagnostics to disk. 
No or omitted - Do not load diagnostics. 


CMLLOAD 


LISTING 


Causes deck list to be generated for subsequent printing. 
Legal Values: 

Yes - Generate listing. 

No or omitted - Do not generate listing. 


HPACOMP 


HPSORT 


Causes internal sort routine to be used in lieu of SORT /MERGE 5. 
This parameter can be used when SORT/MERGE 5 not available. 

Legal Values: 

I - Use internal sort routine. 

No or omitted - Use SORT/MERGE 5. 




LISTING 


Causes listing of the HPA program to be generated for subsequent 
printing. This listing is quite large and may take several hours 
to print on a remote batch printer. 

Legal Values: 

Yes - Generate listing. 

No or omitted - Do not generate listing. 




XRUN 


Causes HPA to be compiled for execution from local file. 

Legal Values: 

Yes - HPA is compiled and retained on permanent file HP. 

No or omitted - HPA is compiled for execution from system 
library. Binary is included on permanent file CMLBIN. 
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Table 1-6. Batch Job Parameters (Sheet 3 of 7) 



Procedure 


Parameter 


Function 




66X 


Causes Detailed Status Tables for 66X Tape Subsystem to be 
included in HPA. 

Legal Values: 

Yes - Include tables in HPA. 

No or omitted - 66X Detailed Status Tables are not 
included in HPA. 




67X 


Causes Detailed Status Tables for 67X Tape Subsystem to be 
included in HPA. 

Legal Values: 

Yes - Include tables in HPA. 

No or omitted - 67X Detailed Status Tables not included in 
HPA. 




844 


Causes Detailed Status Tables for 844 Disk Subsystem to be 
included in HPA. 

Legal Values: 

Yes - Include tables in HPA. 

No or omitted - 844 Detailed Status Tables not included in 
HPA. 




885 


Causes Detailed Status Tables for 885 Disk Subsystem to be 
included in HPA. These tables are also used to analyze DEMA 
detailed status. 

Legal Values: 

Yes - Include tables in HPA. 

No or omitted - 885 Detailed Status Tables not included in 
HPA. 


MALASSY 


LISTING 


Causes listing of the MALET compiler /executive to be generated for 
subsequent printing. 

Legal Values: 

Yes - Generate listing. 

No or omitted - Do not generate listing. 




PAPER85 


Causes MALET to be assembled for use with 212.5 mm (8.5 in) paper. 

Legal Values: 

Yes - Assemble MALET for use with 212.5 mm (8.5 in) paper. 

No or omitted - Assemble MALET for use with standard 279.4 
mm (11 in) paper. 
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Table 1-6. Batch Job Parameters (Sheet 4 of 7) 



Procedure 



MALDIAG 



Parameter 



SYSVER 



8LPI 



OPLPFN 

OPLUNID 

OPLPW 

OPLPAK 

OPLDTSET 

OPLVSN 

OPLDEN 

DIAG 



LISTOPT 



Function 



Specifies level of NOS for which MALET to be assembled. 

Legal Values: 

N0S25 - NOS 2.5 

N0S24 - NOS 2.4 

NOS23 - NOS 2.3 

NOS6 - NOS 2.2 or NOS 2. 1 

Causes MALET to use print density of 8 lines per inch. 

Legal Values: 

Yes - MALET output printed at density of 8 lines per inch. 

No or omitted - MALET output printed at density of 6 lines 
per inch. 



See notes on SYSOPL elsewhere in this section. 

Specifies which MALET diagnostic to be compiled. 

Legal Values: 

Any three-character MALET diagnostic contained on CML 
release tape. This is required parameter. 

MALET list options. 

Legal Values: 

S - Causes source code to be carried with module binaries. 

L - Causes source and binary listing to be written to list 
file. 

I - Causes all input source lines to be written to list 
file. 

F - Turns on all options (S, L, and I). 

(The list options can be entered in continuous string 
[e.g. , SL, SI, etc. ]. ) 
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Table 1-6. Batch Job Parameters (Sheet 5 of 7) 



Procedure 


Parameter 


Function 




XMAP 


Causes global cross-reference map of all modules compiled to be 
included In output listing. L list option must also be selected 
if global cross-reference map is desired. 

Legal Values: 

Yes - Include global cross-reference map on list file. 

No or omitted - Do not produce global cross-reference. 


MALDOC 


DIAG 


Specifies the MALET diagnostic for which documentation to be 
generated. 

Legal Values: 

Any three -character MALET diagnostic contained on CML 
release tape. This is required parameter. 




DOCTYPE 


Specifies type of documentation desired. 

Legal Values: 

EXT - Specifies external documentation to be produced. 

INT - Specifies internal documentation to be produced. 

BOTH - Specifies both external and internal documentation 
to be produced. 


MLDSBP 


LISTING 


Causes listing of MLD and SBP to be produced for subsequent 
printing. 

Legal Values: 

Yes - Generate listing. 

No or omitted - Do not generate listing. 




SYSVER 


Specifies level of operating system for which MLD and SBP to be 
assembled. 

Legal Values: 

NOS25 - NOS 2.5 

NOS24 - NOS 2.4 

N0S23 - NOS 2.3 

N0S6 - NOS 2.2 or NOS 2.1 
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Table 1-6. Batch Job Parameters (Sheet 6 of 7) 



Procedure 


Parameter 


Function 




OPLPFN 






OPLUNID 






OPLPW 






OPLPAK 






OPLDTSET 






OPLVSN 






OPLDEN 


See notes on SYSOPL elsewhere in this section. 


REGTIO 


DIAG 


Specifies which diagnostic (REGEN or TIO) to be compiled. This is 
required parameter. 

Legal Values: 

REGEN - Compile REGEN. 

TIO - Compile TIO. 




LISTING 


Causes listing of selected diagnostic (REGEN or TIO) to be 
generated for subsequent printing. 

Legal Values : 

Yes - Generate listing. 

No or omitted - Do not generate listing. 


SKDASSY 


LISTING 


Causes listing of SKEDULR to be generated for subsequent printing. 
Legal Values: 

Yes - Generate listing. 

No or omitted - Do not generate listing. 




MMF 


Specifies that SKEDULR is to be compiled for use in an ECS-based, 
multlmainframe environment. 

Legal Values: 

Yes - Assemble SKEDULR for use in multimainf rame 
environment. 

No or omitted - Assemble SKEDULR for use in a single- 
mainframe environment. 




SYSVER 


Specifies level of operating system for which SKEDULR is to be 
assembled. 

Legal Values: 

N0S25 (NOS 2.5). N0S4 (NOS 1.3). 
N0S24 (NOS 2.4). N0SBE6 (NOS/BE 1.5). 
NOS23 (NOS 2.3). N0SBE5 (NOS/BE 1.4). 
N0S6 (NOS 2.0, 2.1, 2.2). N0SBE4 (NOS/BE 1.3). 
N0S5 (NOS 1.4). 
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Table 1-6. Batch Job Parameters (Sheet 7 of 7) 



Procedure 


Parameter 


Function 




OPLPFN 

OPLUNID 

OPLPW 

OPLPAK 

OPLDTSET 

OPLVSN 

OPLDEN 


See notes on SYSOPL elsewhere in this section. 




SYSEDIT 


LISTING 


Causes listing of SYSEDIT directives and actions to 
for subsequent printing. 

Legal Values: 

Yes - Generate listing. 

No or omitted - Do not generate listing. 


be generated 


SYSTAPE 


LISTOPT 


Specifies desired LIBEDIT list options. 
Legal Values: 

C - List directives. 

E - List errors. 

M - List modifications. 

N - List records written to new file. 

F - Give full listing (enable all options). 

Omitted - Do not produce listing. 








(You may combine list options; for example, 
CEM. ) 


CM, CE, or 


UTLCOMP 


LISTING 


Causes listing of requested utility to be generated 
printing. 

Legal Values: 

Yes - Generate listing. 

No or omitted - Do not generate listing. 


for subsequent 




UTILITY 


Specifies utility to be compiled. 
Legal Values: 
MCCOMP 
MCDUMP 
MLTDOC 
MTPLOT 
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COMMON MAINTENANCE SOFTWARE INTERFACE PROCEDURES 

The Common Maintenance Software Interface (CMSI) is a set of CYBER Control Language (CCL) 
procedures that provides a user environment specifically for Engineering Services CML 
usage. These procedures support the local and remote interactive use of CML and selected 
other maintenance software products. CMSI was developed to assist both the expert and 
novice users in CML use and to provide a standard method of accessing these products. 

Because of the CCL features used by CMSI, CMSI is applicable to NOS 2.3 level 617 and later 
versions and is not applicable to NOS/BE or NOS l.X. 

CMSI consists of a library of CCL menu and interactive procedures that will guide the user 
through the steps In using CML. 

The following products are supported by CMSI at CML level L186: 

HPA report generator. 

NPA CDCNET report generator .t 

MTPLOT tape unit report generator. 

DSPLOT disk unit report generator. 

MALET module usage. 

CPU background diagnostics. t 

NOS MST mass storage test.t 

REGEN confidence test. 

TIO confidence test. 

LCN host/host confidence test. 

DSDI dump interpreter .t 

MCDUMP/MCCOMPARE microcode verification. 

Link to ANALDMP. 

Link to CMLUTIL. 

Exit to the NOS operating system. 

CMSI does not attempt to limit the NOS system usage of the customer engineer by deleting 
commands from a commands list or imposing any other limitations. All capabilities 
previously available continue while in the NOS interactive terminal mode. When the CMSI 
procedures are being used, the customer engineer is restricted to the capabilities and 
limitation of CMSI and the NOS CCL protocol. 

CMSI is intended to enhance the usability of CML and remove configuration dependent 
differences. 



1'Non-CML distributed products. 
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CMSI INSTALLATION AND INITIALIZATION 



Installation 



The CMSI procedure files are installed on the permanent file CMLINST as part of the normal 
CML installation process. Refer to the section on CMLINST or BININST in this section. 



NOTE 



When CMSI is used on a NOS 2.3 level L617 
system, because of CCL incompatibilities the 
CMLINST procedure library must be 
regenerated from the CML release tape or 
permanent file. The CMLINST job (not 
BININST) must be run using parameter N0S23 
for the SYSVER parameter. CMLINST can be 
started using either the batch method or the 
INTINST method. The CML, CML1, ... , CML5 
job need not be executed to update CMLINST. 
CMLINST is the only job which must be run. 



Initialization 

Once the CMLINST file has been created, several site dependent parameters within CMSI must 
be initialized. This takes place the first time CMSI is used. 



CMSI INITIALIZATION PARAMETERS 



Parameter 



Form 



Description 



SYSVER 



SITENAMET 



1-6 characters This is the NOS system release level on which CMSI is to 
be run. It allows for the inclusion of release 
dependent CCL features in CMSI. 

1-40 alpha This is the 1-40 character site name to be used on the 
MTPLOT and DSPLOT listings. 



NUMDISK 



number 



This is the number of disks in the site configuration. 
This value is used by DSPLOT. 



MODE 



C or T 



This is the terminal mode of CMSI. Either Terminal 
Capture (C) or available (T). See the following 
paragraphs for more information on the usage modes of 
CMSI . 



UPFN 



file name This is the file name of a current user prolog procedure 
file. Enter file name or (cr) if none. 



OLDHF 



file name 



This is the present name of the HPA history file. 



tSITENAME and OLDHFUN entries must begin and end with a dollar sign ($) if terminal is used 
in line mode. In SCREEN mode, dollar signs are not used. 
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CMSI INITIALIZATION PARAMETERS (continued) 

Parameter Form Description 

OLDHFUN username This is the NOS username under which the HPA OLDHF file 

is cataloged. 

RESIDE YES or NO This is the location of the OLDHF file. If the OLDHF is 

cataloged on a private pack, enter YES. If OLDHF is on 
the normal file base enter NO or (cr). 

REGMST 1-6 characters VSN for the REGEN master data tape. Default is REGMST . 

CMSI is initialized in one of two modes: 

• Total terminal control: 

In this mode, the terminal is 'captured' by the procedures at login and all 
interaction is through them. This mode is used where little or no non-maintenance 
NOS system usage is done by the customer engineer or a user number is dedicated 
exclusively to CML maintenance activities. 

• Available mode: 

In this mode, normal NOS login activity and terminal interaction continues; however, 
a message is issued at login to inform the user of the availability of CMSI and how 
it may be started at the users option. 

CMSI is started by entering the following NOS commands interactively from the CE maintenance 
account , following login. 

BEGIN ,CMSI .CMLINST . 

The CMSI initialization procedure now prompts for the needed parameters. The user must 
supply the needed information, as requested, to complete the initialization of CMSI. More 
information about any parameter is available in the HELP displays within CMSI, [enter a 
question mark (?) followed by a carriage return (CR)]. When all required entries have been 
made, CMSI will complete the initialization process and display its main menu. You may then 
select the maintenance activity desired or exit. 

All future uses of CMSI will display this last menu. Initialization is only required at the 
first usage following installation or when reinitialization is required because of site 
reconfigurations . 

Reinitialization 

The initialization routine may be run at any time to change the site parameters by selecting 
the REINITIALIZE option from the main menu. The procedures will then display the current 
parameter settings and allow changes. A carriage return (CR) is used to proceed without 
changing that parameter. 

CMSI OVERVIEW 

The structural overview of CMSI is shown in figures 1-6 and 1-7 . 
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Figure 1-6. CMSI Primary Menu Procedure Structure 



CMSIOOOt... Common Maintenance Software Interface 

CMSI 100... Analysis Interface 

CMSI110...HPA Interface 
CMSI120...CDCNET NPA Interface 
CMSI 130.. .MTPLOT/DSPLOT Interface 

CMSI200... Diagnostic Interface 

CMSI210...MALET 

CMSI220...CPU Background Diagnostics 

CMSI230...MST Mass Storage Confidence 

CMSI240...TIO/REGEN 

CMSI250...LCN Host to Host Confidence Test 

CMSI300 . . .Dump Interface 

CMSI320... Batch Use of DSDI 
CMSI330... Interactive Use of DSDI 
CMSI340 . . .MCDUMP/MCCOMP 
CMSI350 . . .ANALDMP Interface 

CMSI400... Utilities 

CMSI4 10... Access to CMLUTIL 
CMSI420...EST Display 
CMSI430 . . .Update CMLINST 

CMSI500... Reinitialize the CMSI Parameters 

CMS 1600... Ex it to NOS Operating System 

CMSI700... Logoff the Terminal 



tThroughout this manual CMSIxxx refers to procedure names within CMSI. 



Figure 1-7. Procedure Record Names for the Primary Levels of CMSI 
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CMSI USAGE 

Following the CML installation and the CMSI initialization, CMSI will either be started by 
the User Prolog file at login time (terminal capture mode), or be available to be started as 
needed by entering the following command sequence. 

1. Login to the NOS system. 

2 . Set the terminal characteristics with either the SCREEN or TRMDEF commands as 
required by the terminal type in use. CMSI may be used on either a screen or line 
terminal. 

3. Type: 

BEGIN , CMSI .CMLINST. 

This will bring CMSI into execution and display the main menu. Refer to figure 1-8. 

The use of CCL procedures allows for the inclusion of help information within the 
procedures. Additional information is always available to the procedure users. For menu 
procedures (those selections made by menu number), help is obtained by typing '?' and (CR) 
for general helps or by typing 'number?' (CR) for help information on that particular 
numbered selection. 

For interactive procedures (those that require a parameter entry), help is obtained by 
entering a '?' at the prompt for a parameter. 



CMSI STRUCTURE 

CMSI consists of a library of CCL procedures distributed on CML and installed via the CML 
installation procedures. (See the CML installation section of this manual for CML 
installation instructions.) Refer to figure 1-6 as a supplement to the following menus. 



CMSIOOO - CMSI Main Menu 

Figure 1-8 provides the first selection of the type of maintenance software activity to be 
performed. Selection is made by number. Helps are available for further definition of any 
topic. The products available are listed on the right of each selection. CMLLEV indicates 
the current revision level. 



CMSI - COMMON MAINTENANCE SOFTWARE INTERFACE - CMLLEV 



1. ANALYSIS INTERFACE - HPA / NPA / MTPLOT-DSPLOT 

2 . DIAGNOSTICS INTERFACE - MALET / CPU / MST / TIO / REGEN / LCN 

3. DUMP INTERFACE - DSDI / MCDUMP / MCCOMP / ANALDMP 

4. UTILITIES INTERFACE - CMLUTIL / EST TABLE / MOD CMLINST 

5. REINITIALIZE CMSI - RESET ANY CMSI PARAMETERS 

6. EXIT TO NOS - EXIT TO THE NOS OPERATING SYSTEM 

7. LOGOFF - TERMINATE THIS TERMINAL SESSION 



PMcmfifiN oir t vrT nv mitmkwb rvp tvdit •> tthb uttt t> 



Figure 1-8. Common Maintenance Software Interface 
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CMSI100 - Analysis Interface 

Figure 1-9 refines the selection of data ANALYSIS activity to be performed, either HPA, NPA, 
or one of the two available trends analysis plots MTPLOT or DSPLOT. 



1. HPA INTERFACE 

2. NPA CDCNET INTERFACE 

3. MTPLOT / DSPLOT INTERFACE 

9. RETURN TO MAINFRAME MENUS 



CMSIIOO SELECT BY NUMBER OR TYPE ? FOR HELP. ? 



Figure 1-9. Analysis Interface 



Figure 1-10 is the Analysis Interface Flowchart. 
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Figure 1-10. Analysis Interface Flowchart 
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CMSI1 10 -HPA Interface 

Figure 1-11, as well as the next three figures, completes the HPA job definition by 
prompting for: 

• Job run type: interactive, batch, read, submit, or EST. 

• Report type: S, A, DX, or ALL report types. 

• Device type and/or EST to report on. 

• Number of days from the history file to summarize. 



1. INTERACTIVE RUN 

2. BATCH RUN 

3. READ BATCH OUTPUT 

4. SUBMIT USER HPA JOB 

5. DISPLAY EST TABLE 

9. RETURN TO MAIN CMS I MENU 



CMSI110> SELECT BY NUMBER OR TYPE ? FOR HELP. ? 



Figure 1-11. HPA Interface 



Figure 1-12 is the HPA Interface Flowchart. 



CMSI110 » «- CMSI111 — *■ CMSIHP1 — »- CMSIHP2 

-CMSI112 -f 



Figure 1-12. HPA Interface Flowchart 



CMSI 1 20 - CDCNET NPA Interface 

Figure 1-13 provides CMSI options for use of the CDCNET report generator NPA (on library 
NPANLIB under user number NETADMN). Options to generate four selected reports individually 
and to generate all four together are provided. Option six provides the user to interact 
directly with the CDCNET report generator CRECAR and thereby select any report option 

OU31 1 qKIo *-f\ l-Vip*- nrAnram Tho nr?ov okn..l J *- *.f «-*- «« « « «-l~-. \T~ «--, A —l, n C A n J / im « \ 

*-'—-*•""-*-'- — ~ ~"dw ^j-ugidim *uw uowa. c»iivv*.l.u lc*Ci.cu\-C LUC HCI.WUIR. £Ci lULlUdllUC rtLlei _L y £ fci I- \iSCt\) 

manual listed in the preface. 
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Figure 1-13. CDCNET NPA Interface 



Figure 1-14 is the CDCNET NPA Interface Flowchart. 



Call CRECAR with RN=MCISRP3. 
CMSI120 — - CMSI121 —+— ►Call CRECAR with RN=ETHRRP2. 

V— Call CRECAR with RN=TERMRP2. 
V-" Call CRECAR with RN=HRDWRP2. 
Call CRECAR with RN=ALL. 
Call CRECAR for user parameter entry. 



Figure 1-14. CDCNET NPA Interface Flowchart 



CMSI130 - MTPLOT/DSPLOT 

Figure 1-15 prompts the selection of MTPLOT or DSPLOT. 
Options are: 

• Read a previous weekly report output file. 

• Run a new plot analysis using the performance data history file and last n number of 
days from the HPA history file. (This will not update the performance data files or 
the saved output listings.) 

• Run a weekly plot analysis, update the performance data file and replace the saved 
plot listing (available for selection number 1 In figure 1-15). 
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1. READ PREVIOUS MTPLOT OUTPUT 

2. READ PREVIOUS DSPLOT OUTPUT 

3. RUN DAILY MTPLOT INTERACTIVE JOB 

4. RUN DAILY DSPLOT INTERACTIVE JOB 

5. RUN WEEKLY MTPLOT JOB 

6. RUN WEEKLY DSPLOT JOB 

9. RETURN TO MAIN CMS I MENU 



CMSI130> SELECT BY NUMBER OR TYPE ? FOR HELP. ? 



Figure 1-15. MTPLOT/DSPLOT Interface 



Figure 1-16 is the MTPLOT/DSPLOT Interface Flowchart. 



CMSI130 »CMSI131..read 

CMSI1 33. .daily run 
CMSI1 35. .weekly run 



Figure 1-16. MTPLOT/DSPLOT Interface Flowchart 

CMSI200 - Diagnostic Interface 

Figure 1-17 is the primary menu for all diagnostics available to CMSI. 
Options are: 

• MALET. 

• CPU tests [those delivered on CEDIAG (REL2B) NOS PL] . 

• MST (the NOS development Mass Storage Test).t 



tThe MST test is currently part of the NOS operating system and is intended only as an 

internal development tool. As such it is not supported by the diagnostic development 

group nor Engineering Services. Its continued inclusion is at the discretion of the 

programming division. PSRs submitted may not be answered and are not subject to the same 
criteria as those against supported products. 
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• REGEN/TIO. 

• EST Table. 



1. RUN A MALET DIAGNOSTICS 

2. RUN A CPU DIAGNOSTIC (MAINTENANCE DIAGNOSTIC) 

3. RUN NOS TEST MST 

4. RUN TIO / REGEN 

5. RUN LCN HOST/HOST CONFIDENCE TEST 

6. DISPLAY EST TABLE 

9. RETURN TO MAIN CMS I MENU 



CMSI200> SELECT BY NUMBER OR TYPE ? FOR HELP. ? 



Figure 1-17. Diagnostic Interface 



Figure 1-18 is the Diagnostics Interface Flowchart. 
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Figure 1-18. Diagnostics Interface Flowchart 
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CMSI210 - MALET Interface 

At this menu, figure 1-19, the selection of MALET run mode, MALET Help, or Display of the 
machine EST is made. 

Confidence level of testing does not cover all available MALET diagnostics, only those that 

allow testing at access level of three and have a set of modules defined as a confidence 

test. Data path can be selected or primary path can be used as a default. The minimum 

access level (AL) possible is used. Not all tests can be run in confidence level mode. 

Manual mode will allow running of any module(s). Path and access level (AL) are selectable. 



1. MALET CONFIDENCE LEVEL TESTING 

2. MALET MANUAL ENTRY MODE TESTING 

3. MALET HELPS 
A. DISPLAY EST 

9. RETURN TO MAIN CMS I MENU 



CMSI210> SELECT BY NUMBER OR TYPE ? FOR HELP. 



Figure 1-19. MALET Interface 



Figure 1-20 is the MALET Interface Flowchart. 



CMSI210 
\ 



-*- CMSI211 
CMSI213 - 



CMSI116 



- CMSI212 

CMS2131 
CMS2132 



CMS2135 



CMSI116 
CMS2123 

MLTTAP1 — ^MLTTAP2 
MLTFTP 



CMS2125 
CMS2127 



Figure 1-20. MALET Interface Flowchart 



CMSI220 - CPU Background Diagnostics 

Selecting the CPU test option from menu CMSI200 starts this series of procedures that gather 
the necessary parameters for the submission of one of the NOS supplied background 
diagnostics as a batch job. 

This is an interactive Procedure and does not "resent a menu as in previous procedures. 
Parameter selections are made in response to individual questions. 
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The following parameters are necessary to submit a CPU test to NOS: 

• Test name. 

• CPU - 0,1, both. 

• Run time . 



NOTE 



When MAINTENANCE or individual tests are 
started from the system console, these 
tests are given a low system priority and 
only run when no other activity requires 
the CPU or memory space (background 
diagnostic). When started from CMSI, these 
batch jobs are given the same priority as 
other submitted batch jobs in the system 
and will compete for system resources with 
the normal users. It is recommended that 
not many of these be submitted during the 
prime customer operation time. 

CMSI230 - MST Mass Storage Confidence Interface 

Selecting the MST option from the menu CMSI200 starts an interactive dialog to gather 
parameters necessary to run the NOS Mass Storage Test (MST). 

Parameters select : 

• Run batch or interactive mode. 

• Mass storage EST to test (the keyword LIST will display the disk devices in the EST). 

• Number of sectors to test. 

• Number of passes to repeat the test. 

Figure 1-21 is the MST Mass Storage Confidence Interface Flowchart. 



CMSI230 — *- CMSI231 — *- CMSI116...List EST 

-CMSI232...RunMST 



Figure 1-21. MST Mass Storage Confidence Interface Flowchart 
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CMSI240 - TIO/ REGEN Interface 

Selecting the TIO/REGEN option from menu CMSI200 displays the menu that is running options 
for the I/O Confidence Tests TIO and REGEN, figure 1-22. 

Details of these tests are available in section four of this manual. 

The TIO and REGEN options are: 

• Run a TIO job on RMS media. 

• Run TIO on a tape device. 

• The final TIO option allows the user to select TIO run parameters before submitting 
the job. 

REGEN follows the same pattern as TIO: 

• Write only on RMS. 

• Write on magnetic tape. 

• Allow user input of REGEN parameters . 

REGEN also provides options to run in ISOLATE mode and in GENERATE mode. 



1. 


EXPRESS 


TIO ON DISKS 








2. 


EXPRESS 


TIO ON TAPE 








3. 


RUN TIO 


MANUAL BATCH MODE 






4. 


EXPRESS 


REGEN ON DISK 








5. 


EXPRESS 


REGEN ON TAPE 








6. 


RUN REGEN MANUAL MODE 








7. 


RUN ISOLATE MODE ON TAPE 


99 FILE 




8. 


GENERATE REGEN DATA FILE 








9. 
CMS I 








CMS I 
' FOR 


MENU 
HELP . ? 


J\Ii J. U IXIN X \J i.*Ui-L LI 

240> SELECT BY NUMBER OR TYPE ' 



Figure 1-22. TIO/REGEN Interface 
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Figure 1-23 is the TIO/REGEN Interface Flowchart. 



CMSI240 — ►- Submit batch TIO job. 

Submit batch REGEN job. 
Submit REGEN Isolate job. 
Submit REGEN Generate job. 
CMSI243 CMSITIO 
CMSI246 CMSIREG 



Figure 1-23. TIO/REGEN Interface Flowchart 

CMSI250 - LCN Host to Host Confidence Test 

Selecting the Run LCN Host/Host Confidence Test option from menu CMSI200 displays the 
processing options for LCN confidence testing, figure 1-24. 

Two options are provided for LCN testing, 1) express testing where a minimum of parameters 
must be supplied; and 2) manual testing where all parameters are available to the user. 

Express required parameters are: 

• Remote Host Logical ID. 

• Remote Host User Name. 

• Remote Host Password. 

• Remote Host Family Name. 

Express testing assumes a NOS-to-NOS link, testing to be with three default data patterns 
and CMSI canned remote host directives. 



1. EXPRESS LCN CONFIDENCE TEST 

2. MANUAL LCN CONFIDENCE TEST (PARAMETER ENTRY) 
9. RETURN TO MAIN CMSI MENU 



Figure 1-24. LCN Confidence Test Options 
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Selection 2 provides access to manual testing. 

All CMSI250 parameters are available to the user and are as follows: 

Remote Host Logical ID. 

Remote Host Family Name, User Name, Password. 

Remote Host Operating System type. 

File names for each of 3 data formats, display code, ASCII 8, and binary. 

Data file length in kilobytes is using default data patterns. 

Remote Host directives file name. 

Terminal page wait control (PG=). 

The user is prompted for each parameter. Most parameters have defaults. See the "Help" 
available in the procedures for details . 

Figure 1-25 is the CMSI250 flowchart. 



CMS1250 — ► CMSI256 — ► CMSI257 — ► CMSI258 



Figure 1-25. 1CN Flowchart 



CMSI300 - Dump Interface 



Figure 1-26 provides an interactive CMSI interface to DSDI, the NOS dump interpreter, for 
fault determination and MCDUMP/MCCOMP routines for microcode cache memory parity error 
checking . 

Options are: 

Submit job for batch use of DSDI with canned directives. 

Batch use of DSDI with user selected or canned directives. 

Interactive DSDI with user selected or canned directives. 

MCDUMP/MCCOMP verification of microcode images from an EDD tape. 

MCDUMP update of the GOODMC permanent file. 

Access to ANALDMP procedure of CMLUTIL. 

All selections cause CMSI to prompt for three common parameters needed by all the following 
procedures : 

• Machine type CYBER 7xx or 8xx (700 or 800). 

• VSN of the EDD dump tape. 

• The CIP level of the EDD used to take the dump (that is; CIP L004 = 4). 
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1. EXPRESS BATCH DUMP 

2. BATCH DUMP, USER SELECTED DIRECTIVES 

3. INTERACTIVE DSDI USAGE 

4 . MCDUMP/MCCOMP 

5. RUN ANALDMP 

9. RETURN TO MAIN CMS I MENU 

CMSI300> SELECT BY NUMBER OR TYPE ? FOR HELP. ? 



Figure 1-26. DUMP Interface 



Figure 1-27 is the DUMP Interface Flowchart. 
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Figure 1-27. DUMP Interface Flowchart 
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CMSI320 - Batch Use of DSDI 

When batch processing is selected, the user is prompted to select either CMSI canned 
directives or input DSDI directives interactively before batch job is submitted. Figure 
1-28 is the Batch Use of DSDI Flowchart. 



CMSI301 —+■ CMSI302 — - CMSI320 — - DSDIBAT... Submit job 



Figure 1-28. Batch Use of DSDI Flowchart 



CMSI330 - Interactive Use of DSDI 

When interactive processing is selected, the user is prompted for the use of CMSI canned 
DSDI directives, directives saved on an indirect permanent file in the users catalog, or 
interactively supplied directives. The user may also choose to print a batch copy of the 
dump produced in addition to the copy returned to the terminal. Figure 1-29 is the 
Interactive Use of DSDI Flowchart. 



CMSI330 — *- DSDIX1 — *■ DSDIX2 



Figure 1-29. Interactive Use of DSDI Flowchart 



CMSI340 - MCDUMP/MCCOMP 

By selecting the MCDUMP/MCCOMP option, the user must select either a verification of the 
microcode image from an EDD dump tape or an update of the permanent file image of GOODMC. 



CMSI400 - Utilities Interface 

Figure 1-30 provides CMSI access to: 

• CMLUTIL. 

• Equipment Status Table. 

• Updating of CMLINST deck. 
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1. RUN CMLUTIL 

2 LIST EST TABLE 

3. UPDATE CMLINST AND CMS I 

9. RETURN TO MAIN CMS I MENU 

CMSI400> SELECT BY NUMBER OR TYPE ? FOR HELP. 



Figure 1-30. Utilities Interface 



Figure 1-31 is the Utilities Interface Flowchart. 
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Figure 1-31. Utilities Interface Flowchart 



CMSI410 - Access to CMLUTIL 

Selecting the CMLUTIL option branches these procedures to the CMLUTIL procedures described 
earlier in this manual. The CMLUTIL procedures provide an interactive method to recompile 
and install any component of CML. 

CMSI420 - EST Display 

Selecting EST displays the current equipment status table of the machine. (This option is 
the same as that available to several procedures within CMSI.) 
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CMSI430 - UPDATE CMLINST and CMSI 

Selecting UPDATE CMLINST and CMSI allows the user to apply a modset against the CML 
installation procedures. The modset must be constructed in UPDATE format and reside on an 
indirect permanent file INSTMDS. The CML program library CMLPL must also be permanent (as 
created by the CMLUTIL option CMLLOAD). 

CMSI500 - Reinitialize the CMSI Parameters 

Selecting number five from the CMSIOOO main menu will allow the user to change the 
installation parameters used by CMSI. This is only necessary if errors are found in the 
parameters in use or site reconfiguration requires parameter adjustments. This is the same 
initialization that occurs following the CML installation. Figure 1-32 is the 
Reinitialization Flowchart. 



CMSI500 > CMSI502 > CMSI501 

> CMSI503 



Figure 1-32. Reinitialization Flowchart 



Procedure CMSI501 contains the code for the following procedures as data records: 



Data 




Records 


Procedures 


LIB501 


BININST, INTINST, INTSYS, INTHDW, 




CMLINST, CML, CML1 through CML6 


CMS 1502 


CMS 1502, OLDPARM 


CMSI 


CMSI 


CMSI116 


CMSI116, ESTPRT 


CMSI 139 


CMSI139 


CMSIPRO 


CMSIPRO 



CMSI600 - Exit to NOS Operating System 

Selecting number six from the CMSIOOO main menu will terminate the CMSI procedures and 
return to the NOS interactive subsystem. The CMLINST procedure library is returned. CMSI 
may be restarted as required by typing: 

BEGIN , CMSI , CMLINST . 

CMSI700 - Logoff the Terminal 

Selecting number seven from the CMSIOOO main menu will terminate the CMSI procedures by 
logging the user off the NOS system. 



1-58 



60455980 V 



MALET LANGUAGE 



MALET is an acronym for the Maintenance Application Language for Equipment Testing. It 
provides a set of commands capable of driving 6000/CYBER 70/CYBER 170/CYBER 180 peripherals 
after being granted access by the operating system. MALET executes under the NOS, NOS/VE, 
and NOS/BE operating systems, but CYBER 170 Model 176 support is limited to I/O devices 
attached to the Peripheral Processor Subsystem (PPS) chassis. 

A Central Processor Unit (CPU) executive is installed in the operating system to allow the 
writing of maintenance tools in the MALET language. After Installation, maintenance 
routines can be written and stored as permanent files. These files do not become part of 
the operating system and may be released bypassing the normal software release mechanism, as 
they represent application-type programs. 

The MALET compiler and executive are written in the 6000 COMPASS assembly language and form 
a common product which interfaces with the operating system. The operating system interface 
routine, CVL, is required for MALET to run. Diagnostics are written in the MALET language, 
compiled into executable Peripheral Processor (PP) code by the MALET compiler, loaded and 
linked by the MALET compiler, and executed by the PP driver and its product overlays. 



MALET ELEMENTS 

MALET is composed of the following elements: 

• An executive, which controls the PP driver and provides a user interface. 

• A compiler, which compiles high-level, low-level, and non-1/0 language commands into 
executable PP code subroutines called modules. 

• An executive/PP driver interface residing in Central Memory (CM). 

• A PP driver, which executes non-1/0 statements. 

• Product overlays for the PP driver interface, which execute low-level and high-level 
1/0 language commands. 

• Low-level I/O language commands (such as CONNECT, STATUS INPUT, OUTPUT, and 
FUNCTION), which are designed for channel interfaces and controllers and which are 
not device oriented. 

«. High-level 1/0 language commands (such as REWIND or ENDFILE for tape units and PRINT 
or EJECT for printers), which are designed for specific hardware families. 

• Non-1/0 language commands, which are control module program flow and data in the PP 
operating registers and buffers. Non-1/0 commands may apply to both the high-level 
and low-level languages . 

• Seven MALET local files: INPUT, OUTPUT, LIST, RANDOM(RFILE) , PUNCH, BINARY, and 
SCRATCH. 

A more detailed description of these elements follows . 
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EXECUTIVE 

The executive is brought to a control point in the operating system by the MALET call. It 
then resides in a designated CPU area with the MALET compiler. 

Input to the executive is in one of two forms: directives which are executed by the 
executive or source code which is saved for the compiler. The executive performs the 
following tasks : 

Acts upon directives. 

Saves source code for the compiler. 

Inputs and outputs compiled modules to or from the random file. 

Drives the system console display. 

Controls the PP driver and product overlays. 

Accepts PP requests for assistance during the execution of MALET modules. 

Data input to the executive that is not recognized as a directive is assumed to be source 
code and is saved in a source code buffer. Any data which does not begin with either an 
alphabetic character, or a plus or minus sign is considered to be source data. The MALET 
executive provides the following capabilities for the input of directives and source code. 

• Input can be from the system K/L display, the input file, or a local file. A module 
taken from any of these sources may be read, compiled, and executed by the executive. 

• Input can be from an input file or from a local file with modifications from the 
system K/L display. 

• Precompiled modules can be loaded from a local file and executed. 

• A remote batch job can contain executive directives and source code to be compiled 
and/or executed with the dutput being returned to the remote station. 

• Remote batch jobs can obtain source code or precompiled modules from a local file 
for execution. 

Typically, a number of modules are required to form a total diagnostic. The executive 
allows the user to run specific modules in a chosen sequence with the option to loop on a 
single module or a series of modules . 

The executive reads a complete module into the module buffer and source code, if present, is 
moved to the source code buffer. The source code may be displayed, modified, and/or 
recompiled. If the module is executed, PP code is read from the binary code block (figure 
2-1) to the PP instruction stack by the PP driver. If there are any DATA statements in the 
module, this data is read to the PP output buffer for access by the user. 

The output-of -results mechanism within the MALET language allows the user to issue messages 
to the system B display, the dayfile, and/or the output file. Additional capabilities allow 
the user to accumulate error messages in the PP display buffer and to control the time at 
which a picture of the display is sent to the active output file . 
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COMPILER 

The compiler compiles source code in the form of MALET language commands into PP executable 
binary code. It can also produce a listing of the source code and binary PP code on the 
output file . 

The interface between the executive and the compiler consists of a source code buffer which 
contains a maximum of 120 (decimal) source code lines, and a module buffer of 1100 CM words, 
in which the compiler stores the binary code it produces from source code. 

The module buffer (figure 2-1) also holds MALET modules retrieved from the random file for 
execution by the PP driver. 







7 CM words (fixed) 

- 168 CM words 

- 77 CM words 

128 CM words (maximum) 

720 CM words (maximum) 




HEADER BLOCK 


FORMAT STATEMENTS BLOCK 


COMPILED DATA BLOCK 


BINARY CODE BLOCK 


SOURCE CODE BLOCK (optional) 







Figure 2-1. Module Buffer Memory Format 



The segments of the module buffer serve the following purposes: 

• The seven-word header block, contains data pertinent to loading and executing the 
module . 

• The format statements block contains messages defined for use during module 
execution. 

• The compiled data block contains data that is sent to the PP output buffer (prior to 
module execution) for use by the module during execution. 

• The binary code block contains the executable code generated by the MALET compiler. 
This code is transferred to the PP instruction stack when the module is executed. 

• The source code block contains the MALET language statements which were used by the 
compiler to form the binary code block. This block can be viewed on the K/L display 
when the module is executed. When the source code is present, the user can change 
the code, recompile, and reexecute the module. The source code is only saved with 
the module when the source option is specified on the COMPILE directive. 
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EXECUTIVE/ PP DRIVER INTERFACE 

The executive/PP driver interface is a block of consecutive CM locations subdivided to 
perform the monitoring activities described in table 2-1 . 



Table 2-1. Executive/PP Driver Interface Memory Distribution 



Description 


CM Word Length 


Security word 


1 


Input register 


1 


Output register 


1 


Message buffer 


5 


PP display buffer 


123 


PP plot buffer 


40 


PP checkpoint buffer 


599 


Scratch file working buffer 


70 


Module buffer 


1100 


Product overlay error message buffer 


120 


Standby PP communications 


2 



Executive commands to the PP driver are processed through the input register and message 
buffer. PP requests to the executive are processed through the output register and message 
buffer. 



PP DRIVER 

The PP driver portion of MALET, which resides in the PPS with the product overlays, is a 
Maintenance Language Driver (MLD). It executes the instructions in the binary code block of 
the module buffer. The PP driver is called into operation by the executive RUN directive. 
It remains in operation until one of the following conditions occur: 

• The executive processes a STOP directive and passes it to the driver. The PP stops 
when a logical breakpoint (such as a RES or REL sequence) is reached. 

• The PP driver executes an END statement. The PP drops the control point and flags 
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• The executive detects a run time limit. This limit may be set using the TL option 
on the executive PARAM directive. The time limit condition is only encountered in 
the terminal mode. 



• 



The PP driver detects that more than 2 seconds have elapsed since the last release 
of the assigned I/O channel to the operating system. 



MALET modules execute from the instruction stack in the PP driver. The executive loads PP 
code into the instruction stack from the binary code block of the module buffer and 
transfers control to the PP driver. The PP driver executes return jumps from the 
instruction stack to PP driver subroutines for assistance in executing some commands. 

Communications between the PP driver and the product overlays are accomplished by return 
jumps from the instruction stack to command subroutines in the product overlays. Parameters 
are passed to the subroutines through the PP direct cells. Results generated by the product 
overlays are stored into areas defined by the parameters, usually the product overlay input 
data buffer, output data buffer, or status buffer. 



PRODUCT OVERLAYS TO PP DRIVER INTERFACE 

The PP product overlay is a specialized overlay to the basic PP driver whose purpose is to 
drive specific I/O devices. All I/O related commands executed out of the instruction stack 
make return jump calls to the product overlay to accomplish the task. 

Command subroutines within the product overlay consist of fixed and relocatable areas. 
Jumps from the instruction stack proceed to the fixed areas where other jump instructions 
direct execution to the appropriate subroutine. This method of first jumping to a fixed 
area offers two advantages : 

• Entry points to the command subroutines can be defined in the compiler allowing it 
to generate its own return jumps. 

• Product overlays can be significantly modified without the necessity of changing the 
entry points defined in the compiler. 

Once the task is complete, the product overlay returns control to the instruction stack 
where the module continues execution. 

I/O channel failures, I/O sequence errors and range errors on data buffers are processed in 
the product overlay as follows: 

• The error code is set in the error code (EC) register. 

• The current line number is set in the error address (EA) register. 

• The error message index is set in the error message (EM) register. 

The overlay completes error processing by jumping to the PP driver error exit sequence. 



LOW-LEVEL I/O LANGUAGE COMMANDS 

The low-level I/O language commands apply to all 3000 and 6000 computer system equipments as 
well as buffer controller devices on 6000 CYBER 70 CYBER 170 CYBER 180 channels. 
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This level of language is primarily used to test I/O channel interfaces and controllers. PP 
code generated by the compiler passes parameters to direct cells in the PP and return jumps 
to a subroutine in the PP overlay to accomplish the command task. The compiler generates PP 
code for performing direct I/O channel operations only when inputting the real-time clock 
for use as an operand. Normal I/O is through the product overlays. 



HIGH-LEVEL I/O LANGUAGE COMMANDS 

The high-level I/O language commands in MALET are designed and fitted for specific hardware 
families. The compiler generates PP code, which passes parameters to the PP direct cells 
and return jumps to the PP product overlay to accomplish the task. This level of language 
is primarily used to test peripheral units. 



NON-I/O LANGUAGE COMMANDS 

The non-1/0 language commands supplement both levels of I/O commands. The primary purpose 
of the non-1/0 commands is to control program flow within a module and to supervise data 
within the PP operating registers and buffers. 

The MALET compiler creates executable PP code from the non-1/0 commands in one of the 
following formats: 

• Code that executes with no assistance. 

• Code that requires assistance from basic PP driver subroutines. 

• Code that executes entirely through PPU driver subroutines. 

The compiled non-1/0 commands never perform direct CM reads or writes . If a command 
requires communication with CM or the CPU executive, the communication is performed by PP 
driver subroutines. 



MALET LOCAL FILES 

The seven MALET local files are the INPUT, OUTPUT, LIST, RFILE, PUNCH, BINARY, and SCRATCH 
files. Briefly stated, their purposes are: 

• INPUT contains source code and executive directives. 

• LIST and OUTPUT contain module listings and pictured data. 

• RFILE contains compiled modules for execution. 

• PUNCH contains source buffer data placed there by an executive PUNCH directive. 

• BINARY is a sequential file containing compiled modules (available to RFILE). 

• SCRATCH is a local scratch file used for read/write data, system commands, and 
controlware . 
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STRUCTURE AND ORGANIZATION 

In addition to the previously described elements of the MALET language, knowledge of certain 
details of structure and organization is essential for a more complete understanding of 
MALET. Following are descriptions of MALET modules, registers and buffers, memory 
requirements, and data organization. 



MODULE 

The smallest executable MALET diagnostic is a module. It consists of a maximum of 120 
(decimal) lines of source code separated into four divisions. 

• The identification division names the module and describes the device type and 
specific device codes supported. 

• The data division is optional and may contain: 

Data statements, which are used within the module. 

Format statements, which define messages for use within the module. A maximum 
of eight microsubstitutions can be made within each format statement with a 
maximum of 24 format statements allowed per module. 

Equate statements, which equate a user-specified name to an octal or decimal 
value. A maximum of 20 equates are allowed within the module. The equated 
value can be used for any variable that allows an octal or decimal value. 

Base statements, which define the base (octal or decimal) of numeric values used 
within the module. The default base is octal, but any value can be followed by 
a B (octal) or D (decimal) to provide a specific base for that number. 

Comment statements, which begin with either a slash (/) or an asterisk (*) and 
document the purpose and use of the module. These statements can appear 
anywhere between the identification and termination divisions of the module. 

• The executable code division contains the commands which are converted to PP code 
for the PP driver. High- and low-level language commands cannot be used together in 
a module. 

• The termination division ends the module and specifies the module entry point. 

Identification of source code lines is performed by MALET, which assigns each line a number 
between and 167 (octal). Additionally, user-assigned statement numbers from to 77 
(octal) or to 63 (decimal) are permitted. Because there are 120 (decimal) source lines 
available and only 63 (decimal) user-defined lines, user-defined lines should be limited to 
statements that require them. 
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REGISTERS AND BUFFERS 



A number of registers and buffers within MALET are used as variables by the MALET language. 
Registers and buffers identified as being user-programmable can have their values altered by 
the user during module execution. Registers that are identified as read-only cannot be 
altered once module execution begins, but can be referenced as operands from the module. 
Read-only registers are loaded using executive directives. 

The following user-programmable registers exist in the PP driver. 



Register Mnemonic 

BO through B15 

WC 

BA 



Description 
Index registers. 
Word count register. 
Beginning address register of buffer first word address (fwa), 



The following read-only registers exist in the PP driver. 



Register Mnemonic 
PO through P9 

WT 

LF 

EC 
EA 

EM 

ES 

DS 

DC 
AL 



RT 



Description 

Parameter registers. These registers are set using the 
executive PARAM directive. 

Words-transmitted register. Contains number of words 
transmitted during the last I/O operation. 

Last-function register. Contains the last function code issued 
to I/O. 

Error code register. Contains the last posted error code. 

Error address register. Contains the module source code line 
where the last posted error occurred. 

Error message index register. Contains the index that refers to 
an error message in the module format block. 

Executive switch register. Contains bit switches referenced by 
modules executing in a PPU and driving a device directly 
connected to the I/O channel. 

Diagnostic switch register. Contains bit switches referenced by 
modules executing remotely in devices such as the Loosely 
Coupled Network (LCN) and the Federal Standard Channel (FSC). 

Device code register. Contains the device code of the assigned 
device . 

Access level register. Contains the access level of the 
assigned device. 

Program address register. Contains the current module source 
line number being executed. 

Real-time clock register. Contains the value of the real-time 
clock. This register may be referenced as an operand only in a 
few specific cases . 



60455980 T 



The following buffers exist in each PP driver product overlay. 

Register Mnemonic Description 

OB Output buffer. Contains 500 (octal) words of data from the PP 

to be written to a device. 

IB Input buffer. Contains 500 (octal) words of data from a device 

to be read by the PP. 

SB Status buffer. A read-only buffer containing 100 (octal) words 

of status input from the assigned device. 

Buffers can be directly referenced with octal or decimal values. Buffers can be indirectly 
referenced using either equated values or registers and optional octal or decimal values . 

Examples : 

IB(20) Input buffer directly referenced by an octal value. 

0B(8) Output buffer directly referenced by a decimal value. 

SB(GENSTl) Status buffer indirectly referenced by an equated value. 

0B(B1) Output buffer indirectly referenced by an index register. 

SB(Bl+5) Status buffer indirectly referenced by an index register summed 

with an octal value. 

The default base for numeric fields is octal. The occurrence of an 8 or 9 in a numeric 
field indicates the field is decimal and causes it to be converted to an octal value. If a 
postradix of B or D is present, the number is interpreted according to the postradix. 

Examples : 

LINE=78 78 is interpreted as 116 (octal). 

LINE=72D 72 is interpreted as 110 (octal). 

ASSIGN, AL=8,CH=1 AL is interpreted as 10 (octal). 

LINE=71B 71B is interpreted as 71 (octal). 



EXECUTIVE AND DIAGNOSTIC SWITCH REGISTERS 

The MALET compiler supports the following keywords as equated values allowing easy reference 
to specific bits of the ES and DS registers. These values can be used anywhere a constant 
or equated value is legal. 
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ES Register 


Keyword 


Repeat 


Description 


RM 


module . 


RC 


Repeat 


condition. 


MS 


Module 


stop (repeat 



DS Register 



stop on error). 

CS Condition stop (repeat 

condition or stop on error). 

DL Dayfile log. 

PD Print log or dayfile log. 

SE Stop on error. 

SL Scoping loop (repeat module 
or condition, do not stop on 
error). 

CM Repeat condition or module. 

TM Terminal mode. 

PL Print log. 

KL Assign K/L display. 



Keyword 




Description 


RM 


Repeat 


module . 


RC 


Repeat 


condition. 


MS 


Module 


stop (repeat 



on error) . 

CS Condition stop (repeat condition or 
stop on error) . 

BM Beginning-of -module stop. 

CE Condition end. 

51 Programmable switch 1 . 
SE Stop on error. 

CM Repeat condition or module. 

BC Beginning-of -condition stop. 

BT Beginning-of -test stop. 

TE Test-end stop. 

ME Module-end stop. 

52 Programmable switch 2. 



MEMORY REQUIREMENTS 

The MALET language requires memory space in both the CPU and PPs. The memory requirement in 
the CPU is 24K (octal) as shown in figure 2-2. This memory contains the MALET executive and 
compiler. The memory requirement for a PP is 10K (octal) as shown in figure 2-3. This 
memory is subdivided into specific areas such as the PP driver, instruction stack, and I/O 
and status buffers. 











CPU 
EXECUTIVE 


OCTAL 
24K 







Figure 2-2. MALET CPU Memory Requirements 
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OCTAL 
100 

1000 
1200 

2200 

2000 

500 
500 
100 




DIRECT CELLS 


SYSTEM RESIDENT 


INSTRUCTION STACK 

(MODULE 
BINARY CODE) 


PP 
DRIVER 


PRODUCT OVERLAY 


INPUT BUFFER 


OUTPUT BUFFER 


STATUS BUFFER 







Figure 2-3. MALET PP Memory Requirements 



DATA ORGANIZATION 

Executive directives and source code lines are assembled for input using a 60-character 
maximum line format. Directives are decoded and acted upon immediately. Source code data 
is stored in the source code buffer using a fixed format of 60 characters (6 CM words) per 
line. A maximum of 120 (decimal) source code lines (one module) are permitted, because the 
source code buffer has a fixed length of 720 (decimal) CM words. 
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MALET PROGRAM RELATIONSHIPS 

The MALET excutive calls CVL during the ASSIGN directive to receive validation of system 
devices for maintenance. MALET also calls CVL to return the device during the exit sequence, 

The MALET executive requests the operating system to load MLD along with the correct product 
overlay Into a pool PP for I/O. 

If SETSW, SB directive is used, the MALET executive requests the operating system to load PP 
program SBP Into a pool PP. SBP monitors the assigned channel for hang conditions and 
automatically disconnects the ASSIGN channel. Refer to figure 2-4. 
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EXECUTIVE 

CPU 
PROGRAM 




MLD 
I/O DRIVER 

PP 
PROGRAM 






^ 
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OPERATING 
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VALIDATION 

PROGRAM 


SBP 
SETSW.SB 
STANDBY 

PP 
PROGRAM 





















Figure 2-4. MALET Program Relationships 
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MALET LANGUAGE FORMAT 

Certain formatting rules exist in the MALET language to simplify interpretation of the three 
basic command groups (non-1/0, high- and low-level I/O) by the compiler. These rules are: 

• Statement Numbering . User-defined statement numbers through 77 (octal) or 
through 63 (decimal) are permitted for labeling MALET statements. Statement numbers 
must appear in positions 1 and/or 2. Single-digit statement numbers may appear in 
either column 1 or 2 with a leading zero optional. 

• Numeric Base for Statement Numbering . If decimal values through 63 are used for 
the user-defined statement numbers, the command BASE DECIMAL must appear in the 
module. Otherwise, octal values are assumed. 

• Position 3 Blank . Position 3 must be blank on all noncomment statements, with the 
exception of data continuation, where a comma in column 3 indicates the 
continuation. Continuation is allowed only on data statements. Comment statements 
have no restrictions concerning position 3. 

• Command Keynames and Successive Blanks . Command keynames begin in either position 4 
or 5. The compiler interprets two successive blanks as the end of the command. 
Each command begins with a keyname followed by a sequence of parameters. 

• Separators . Commas, periods, or single blanks can be used to separate keynames and 
parameters. Two successive commas or periods cause a zero to be stored as a 
parameter. Each successive comma or period after the first two stores an additional 
zero parameter. Single blanks, single commas, and single periods may be used 
anywhere in MALET syntax for clarity or readability. 

Examples : 

Command Description 

DATA (0B(10),C0N) 1,2, ,3 Data items = 1, 2, 0, and 3. 

IB(10) = Bl + 1234 Two succesive blanks following the digit 4 

terminate the command. Single blanks are 
ignored . 

IB(10) = Bl. AND. 0707 Single periods are ignored. 

REWIND, ABT 10 Single commas are ignored. 

• Operators . Operation symbols such as plus (+), minus (-), left and right 
parentheses [ ( and ) ], equal (=), dollar ($), asterisk (*), and slash (/) must be 
used if they appear in the format of the specific command . These symbols are not 
optional. 

• Command Termination and Documentation . Once a command has been properly terminated 
with two successive blanks, any character positions remaining in the 60 character 
line length can be used for documentation purposes. 

• Comment Statements . An asterisk placed in position 1 indicates that the line is a 
comment. Comments can be printed by the executive but are not used by the compiler. 
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OPERATIONAL PROCEDURE 

After the physical installation of MALET, users, file names, and execution modes must be 
defined before MALET can be used. Documentation of these procedures is included with the 
CML/MALET, MALETIVE software release material. 

When MALET is available, it can be called and executed using the following steps in table 2-2. 



Table 2-2. MALET Test Execution Sequence 



Step 


Directive 


Action 


1 


GET or ATTACH 


Assign a scratch file (if required). 


2 


MALET 


Call MALET (console, terminal or batch). 


3 


ASSIGN 


Assign a device for testing. 


4 


PARAM 


Set parameter registers. 


5 


SETSW 


Set switches in the ES register. 


6 


RUN 


Execute the test module(s). 


7 


GO 


Resume execution upon failure. 


8 


DROP 


Terminate use of MALET. 



The MALET executive is called and executed by the MALET control statement, which is 
formatted as follows: 

MALET, pl=m,p2=n, ... ,pn=q 

pl,p2,...,pn Specific keynames 

m,n,...,q User supplied values 

Specific keynames can be used to define local files, override executive default conditions, 
set terminal /batch and keyboard conditions, and specify control list options. 

The following keynames allow the user to supply a local file name in place of a defaulted 
file name. All files must be disk resident for use by MALET. 

Keyname Description 

I or INPUT File containing input source code and MALET executive directives . If 
the file is named something other than INPUT, it is an alternate input 
file read until EOF/EOI is encountered. At that point, the file named 
INPUT is read. (Default: I=INPUT) 

or OUTPUT File that is to receive output data from MALET. If MALET is run using 
L or LIST a terminal, the file name determines where a copy of OUTPUT is destined. 
(Default: 0=OUTPUT or L=OUTPUT) 
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Keyname Description 

If you do not want the terminal to receive a copy of output when 
compiling a large number of modules, use the L or option to select 
an alternative output file and ensure that the input file name is 
COMPILE. With these conditions, the alternative output file 
receives a copy of data not sent to the terminal. 

B or BINARY File where MALET reads or writes precompiled modules for possible 
execution. (Default: B=BINARY) 

P or PUNCH File where source data is written in response to a PUNCH directive. 

R or RANDOM File used for compiled modules. (Default: R=RFILE) 

S or SCRATCH File used as a local scratch file for reading and writing during SYS 
commands. (Default: S=SCRATCH) 

The following keynames allow the user to override default conditions in the executive. 

Keyname Description 

T=nn or TERM=nn Terminal/Batch mode; informs MALET that execution is in terminal 
mode. The nn denotes the screen line length In decimal. The 
parameter is needed only if split compiled module listing over 
laps. Terminal mode is obtained from the operating system. 
(Default=Omltted) 

KL Console Keyboard ON/OFF; informs MALET not to drop when the input 

file is exhausted. The K/L can be turned on via the SETSW KL bit in 
the ES register, but the ES register does not turn on the display. 
(Default: KL=OFF) 

LO=x Control list options. (Default=OFF) Refer to samples in 

appendix D. Available options are: 

x Description 

S Source; turns on the source options in the compiler. 
This option causes the source code to be carried with 
the compiled module binary code when it is saved in the 
random file. The source code is carried regardless of 
errors encountered during module compilation. This 
option significantly increases mass storage requirements 
and module load time. 

L List; turns on the list options in the compiler. This 
option causes the source and binary listings of the 
compiled module to be written to the output file. 

I Input; lists all input source lines, including update 
sequence numbers. 

F Full; turns on all options. 

MAP Causes assembly of MALET modules with listing to form a global 

cross-reference map at end of file on input. Refer to sample in 
appendix D. 

2-14 60455980 T 



Keyname 



Description 



CMSE 



Assembles MALET modules for off-line execution. Any modules 
assembled this way cannot be executed on-line (Default=On-line). 
Following is a CMSE sample job: 

Job/Account Cards 

REQUEST, CML,VSN=CML, NT, PE,F=SI,LB=KU. 

SKIPF.CML.l. 

UPDATE ,Q , P=CML , R=C . 

MALET , I=COMPILE ,CMSE ,B=MSLBIN. 

REQUEST , TAPE ,F=SI ,LB=KU ,NT ,PE ,VSN=TAPE. 

REWIND ,MSLBIN,TAPE . 

COPYBF .MSLBIN.TAPE. 

7/8/9 

* ID, CMSE 

*DF,CMSE17x 

*COMPILE,DIAGt 

7/8/9 

DUMP 

6/7/8/9 



(where DIAG is test to be copied) 



A binary file is created on tape which may be added to the MSL disk 
library with the MSL TDX utility and executed under DEMOT . 



BATCH MODE EXAMPLE 

All default options are used. 

INPUT is from card reader Input file. 

OUTPUT is to the standard Output file. 

BINARY modules are on Binary or do not exist. 

SCRATCH is on Scratch or does not exist. 

PUNCH is on Punch or does not exist. 

RANDOM is on Rfile or does not exist. 

The run is in batch mode, no input is to be read from the system console and no list options 
are forced. 



SYSTEM CONSOLE MODE EXAMPLE 

NOS 



NOS /BE 



ATTACH, T6X. 
MALET (R=T6X,KL) 



ATTACH, T6X, ID=T6X. 
MALET (R=T6X, KL) 



T6X contains compiled modules. 

The K/L parameter allows input from the system console keyboard. 



tRefer to appendix B in this manual for use with DEMA diagnostics. 
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TERMINAL MODE EXAMPLE 

NOS NOS/BE 



ATTACH, T7X. CONNECT, INPUT, OUTPUT 

MALET (R=T7X, T=80 ATTACH, T7X, ID=T7X. 

MALET (R=T7X,T=80) 

The T=80 parameter selects terminal mode with a screen width of 80 columns. If the terminal 
has the input and output files connected, the terminal becomes the MALET input and output 
device. 



MALET EXECUTIVE DIRECTIVES 

The following directives control the MALET executive. All the directives are valid when 
entering the full mnemonic and some are valid when only the first character is entered. 
Commas and single blanks may be used as separators in the directives. 



ASSIGN or A Directive 

Assign a device to MALET for testing. 



ASSIGN EST=aaa,CCH=bb,CH=cc,EQ=dd,UN=ee,DC=ff ,SN=gggggg,AL=hh, SHARE, ESM=NO, 

MSA=i,MSAID=jj,C=k,CSU=l,CSUID=mm,MST=n,MSTID=pp,MSTPH=q,MNE=r,TCU=ss, 
LTA=ttt,AC=uuuuH. 


A EST=aaa 


,CCH 


=bb,CH=cc LTA=ttt,AC=uuuuH. 


aaa 




Equipment Status Table (EST) ordinal; defaultO. If 
EST=N0, the device is not listed in the EST. 


bb 




Concurrent channel number; default=0. 


cc 




Nonconcurrent channel number; default = 0. 


dd 




Equipment number; default=0. 


ee 




Unit number; default=0. 


ff 




Device code; default=0. Before module execution, MALET 
checks the module header to verify that the module 
contains instructions for the assigned device code. Each 
module may support 10 unique devices. 


gggggg 


Media serial number; default=0. 


hh 




Access level; default=0 for non-RMS and default=l for RMS 
(refer to appendix C). 
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SHARE Share channel with another mainframe; no default. The 
SHARE parameter causes the RES (reserve) command to 
release the I/O channel even if the operating system 
does not want to use it. A delay of 1 ms for non-RMS 
devices (100 ms for RMS devices) occurs before the I/O 
channel is requested for further testing. The SHARE 
parameter is not necessary if there is only one access 
to the equipment under test. 

ESM=N0 Disables assignment of ESM space for scratch file when 
device code is 14, indicates a DEMA device (DC=ee). 

i Mass Storage Adapter (MSA) number; default=0. 

jj MSA identification number; default=0. 

k Mounting cartridge; default=N0NE. 

k Description 

NONE No cartridge mounted 

7777B Cartridge mounted manually 

xx/yy Cartridge mounted from location xx and yy. 

1 Cartridge Storage Unit (CSU) number; default=0. 

mm CSU identification number; default=0. 

n Mass Storage Transport (MST) number; default=0. 

pp MST identification number; default=0. 

q MST physical address; default=0. 

r Two character mnemonic identifying assigned tape 
device; no default value. 

r Description 

MT 7 -track tape 
NT 9 -track tape 

ss Trunk control unit (TCU) enables for LCN NAD; no 
default value. Multiple enables can be used if 
DC=301B. 



ss 


Description 


bits 20 


TCU 3 


bits 2 1 


TCU 2 


bits 2 2 


TCU 1 


bits °3 


TCU 



ttt Logical Trunk Address (LTA) of the assigned NAD; no 
default value. This entry is required if DC=301B. 

uuuuH Access Code (AC) of the assigned NAD; no default 

value. This hexadecimal entry is required if the NAD 
AC hardware switches specify a nonzero value and 
DC=301B. 
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Description: 

The ASSIGN directive contains the parameters that MALET uses to request a device for 
testing. The parameters are passed to the operating system interface routine, CVL, where 
they are validated and access to the device is granted. 

Method of Execution: 

The ASSIGN directive passes all parameters to CVL for validation. When validation is 
complete the channel, equipment and unit numbers, the EST ordinal, and the device code are 
saved for reference during module execution. 

If validation is denied and the K/L display switch is OFF, MALET drops the control point. 
If the K/L display switch is ON, an error mesage appears, and MALET retains the control 
point. 

Restrictions: 

• If tape preassignment is used (NOS/BE level 538 or higher; NOS level 531 or higher) 
the only parameter permitted in the ASSIGN directive for the device is MNE=q. The 
other parameters are obtained directly from the operating system. The unit assigned 
is the lowest numbered unit whose type matches the MNE=q specification. 

• If the default access level is insufficient, a new access level (AL=gg) must be 
provided (refer to appendix C). 

• If the desired device is listed in the equipment status table, EST=aaa is sufficient 
to request the device. For multichannel devices, MALET uses only the primary I/O 
channel. 

• The CH and CCH parameters cannot be used together. 

• If the EST parameter is not provided, the channel, equipment and unit numbers 
(CH=bb, EQ=cc, UN=dd) are necessary to request the device. For LCN, MST, or CSU 
equipments, the following special restrictions apply: 

For LCN, the logical trunk address (LTA=sss) must be provided instead of the 
unit number. 

For MST, the MST physical address (MSTPH=p) or MST field must be provided 
instead of the unit number. 

For CSU, the CSU number (CSU=k) must be provided instead of the unit number. 

The following additional restrictions apply to the ASSIGN directive for 844 disk drives. 

• If references outside the preallocated disk area are to be made, the disk pack 
serial number (SN=ffffff) is necessary. 

• If the device is listed in the equipment status table and the EST parameter is not 
provided, the disk pack serial number (SN=ffffff) is necessary. The operating 
system provides the EST parameter and verifies the disk pack serial number. 

• If the device is not listed in the equipment status table and the EST parameter is 
not provided, the device code (DC=ee) is necessary. The disk pack serial number (if 
included) is not verified and a *G0* command is required to use the disk pack. 
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AUTO Directive 

Resume reading from input if previously suspended by STOP. 



AUTO 



Description: 

The AUTO directive resumes a data input operation which was previously suspended by a STOP 
directive. 

If executing a MALET diagnostic from a procedure file with the K/L display selected (two 
sources of control), a STOP from the console suspends reading the input file to give control 
to the user. 

If executing a MALET diagnostic from a procedure file initiated from a terminal with 
I=alternate file name selected (two sources of control), a terminal interrupt (CTRL T) from 
the terminal suspends reading the input file to give control to the user. 



CLRDS Directive 

Disable options in the DS register. 



CLRDS SE,RM,RC,BC,BM,BT,TE,CE,ME,S1,RT,S2 

SE Stop on error; default=ON. 

RM Repeat module; default=OFF. 

RC Repeat condition; default=OFF. 

BC Beginning of condition stop; defaultOFF. 

BM Beginning of module stop; default=OFF. 

BT Beginning of test stop; default=OFF. 

TE End of test stop; default=OFF. 

CE Condition end stop; defaultOFF. 

ME Module end stop; defaultOFF. 

51 Programmable switch 1; defaultOFF. 
RT Repeat test; defaultOFF. 

52 Programmable switch 2; defaultOFF. 
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Description: 

The CLRDS directive sets specific switch options in the DS register to OFF. DS register 
switches are referenced by modules executing remotely in devices such as LCN and FSC. 



CLRSW Directive 

Disable options in the ES register. 



CLRSW RC.SE 


,RM,PL,DL,RT,KL,SB 


RC 


Repeat condition; default=OFF. 


SE 


Stop on error; default=ON. 


RM 


Repeat module; default=OFF. 


PL 


Print log; default=ON. 


DL 


Dayfile log; default=ON. 


RT 


Repeat test; default=OFF. 


KL 


System K/L display; default=OFF. 


SB 


Standby PP option; default=OFF. In this mode the PP 




driver is not assisted in escaping an I/O channel hang. 



Description: 

The CLRSW directive sets specific switch options in the ES register to OFF. The ES register 
switches are referenced by modules executing in a PP. 



COMPILE Directive 

Compile a MALET module. 



COMPILE LIST, SOURCE 




C LIST, SOURCE 




C,L 




C,S 




C,L,S 




LIST 


Write source and binary listings of compiled module to 




output file. 


SOURCE 


Save source code. 
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Description: 

The COMPILE directive calls the MALET compiler to compile instructions residing in the 
source code buffer. 

Adding the LIST option causes the source and binary listings of the compiled module to be 
written to the output file. 

Adding the SOURCE option causes the source code to be carried with the compiled module 
binary code when it is saved in the random file. The source code is carried regardless of 
errors encountered during module compilation. 



Restrictions: 

The SOURCE option defaults to OFF unless LO=S appears in the MALET call statement. 

DEVICES Directive 

Display a list of supported device codes. 



DEVICES 



Description: 

The DEVICES directive displays a listing of valid device codes for use in the ASSIGN 
directive (refer to figure 2-5). 
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MALET - MAINTENANCE APPLICATION LANGUAGE FOR EQUIP. TESTING 



CODES FOR DEVICES 



01=841 DISK 

03=7054/844-4 DISK 

05=7154/7155/844-4 DISK 

07=FMD-885-lX DISK 

ll=FSC-200 MBYTE 

13=RESERVED 

15=7155/885-42 DISK (PFMDW) 

17=RESERVED 

21=415 CARD PUNCH 

23=580-12 LINE PRINTER 

25=580-20 LINE PRINTER 

27=580-16 PFC LINE PRINTER 

31-37=RESERVED 

41=65X 7 TRK TAPE 

43=RESERVED 

45=FSC 7 TRK TAPE 

47=RESERVED 

51=65X 9 TRK TAPE 



02=7054/844-2 DISK 
04=7154/844-2 DISK 
06=819 DISK 
10=FSC-100 MBYTE 
12=FSC-317 MBYTE 
14=7155/855-42 DISK (DEMA) 
16=7155/885-lX DISK (LSFMD) 
20=405 CARD READER 
22=512 LINE PRINTER 
24=580-16 LINE PRINTER 
26=580-12 PFC LINE PRINTER 
30=580-20 PFC LINE PRINTER 
40=60X 7 TRK TAPE 
42=66X 7 TRK TAPE 
44=67X 7 TRK TAPE 
46=RESERVED 
50=60X 9 TRK TAPE 
52=66X 9 TRK TAPE 



CODES FOR DEVICES 



53=698 9 TRK TAPE 

55=67X GCR 9 TRK TAPE 

57=639 9 TRK TAPE 

61=6676 MUX 

63=2550-100 EMULATING 6676 

65=7077-1 LCC 

67=6683 COUPLER 

71=ECS COUPLER 

73-77=RESERVED 

101=MSS-CSU 

104=CCC/MASSTOR SUBSYSTEM 

110=7255/834 DISK(FSDI) 

115=CCC/895 DISK 

200=CYBERPLUS RING PORT 

300=LCN-NAD LOCAL 

302-377=RESERVED 

401=CIU INPUT CONTRL 

500=CYBER/UNIBUS INTERFACE 

7700-7777=QSE 



54=67X 9 TRK TAPE 

56=FSC 9 TRK TAPE 

60=6671 MUX 

62=2550-100 EMULATING 6671 

64=2550 

66=6673 DATA SET 

70=DDP 

72=RESERVED 

100=MSS-MST 

102-103=RESERVED 

105-107=RESERVED 

111-7255/836 DISK (FSDII) 

116-177=RESERVED 

20l-277=RESERVED 

301=LCN NAD REMOTE 

400=CIU OUTPUT CONTRL 

402-7677=RESERVED 

501-7677=RESERVED 



LINE=000 



PPU STATUS=STOPPED 



MODULE=TST01 



Figure 2-5. Sample K/L Displays for DEVICES Directive 
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DROP Directive 

Stop the PP driver and drop MALET. 



DROP 



Description: 

The DROP directive halts any activity in the PP driver and exits from MALET, 

DUMP Directive 

Copy random file to a sequential binary file. 



DUMP 



Description: 

The DUMP directive dumps the contents of the random file to the sequential binary file 
specified by the B option on the MALET call statement. 



GO or G Directive 

Resume execution of the PP driver. 




Description: 

The GO or G directive resumes PP driver execution after it has performed a normal halt. 
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LINE or L Directive 

Choose line number to receive next source code. 



LINE nnn 








L nnn 










nnn 


Source code buffer line number; 
167B are valid. 


values through 



Description: 

The LINE or L directive sets the data input pointer of the source code buffer 
to the line number specified by nnn. The next source code input is placed on 
this line . 



Restriction: 

A valid line number must appear in the directive; there is no default. 

LIST Directive 

List n lines beginning with current line number. 



LIST n 



n Number of lines to be listed; values through 167B 
are valid. 



Description: 

The LIST directive displays n consecutive module source code lines starting with the number 
in the data input pointer. If n exceeds the number of lines remaining in the module, the 
directive displays only those lines available. 
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LOAD Directive 

Load specified module from the random filet 



LOAD MNEnnn 




MNE 


Three letter mnemonic for the module test series. 


nnn 


Module number. 



Description: 

The LOAD directive transfers a module from the random file to the module buffer and displays 
(if available) the first page of source code. 



MALET Directive 

Display MALET executive directives . 




Description: 

The MALET directive displays a list of all the valid executive directives (refer to 
figure 2-6). 
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MAINTENANCE APPLICATION LANGUAGE FOR EQUIP. TESTING 
DIRECTIVE COMMENTS 



AUTO 

CLRDS 

CLRSW 

COMPILE 

DEVICES 

DROP 

DUMP 

GO 

LINE 

LIST 

LOAD 

MALET 

MODULES 

MOVE 

MOVE 

DIRECTIVE 

PARAM 

PICTURE 

PPU 

PUNCH 

PURGE X 

RUN 

SCRATCH 

SEND 

SETDS 

SETSW 

SOURCE 

STOP 

+ 



RESUME READING FROM INPUT FILE 

CLEAR DS REGISTER SWITCHES *CLRDS SE,RT,RM,RC* 

CLEAR SWITCHES *CLRSW SE,RT,DL,RM,PL,SB,KL,RC* 

COMPILE SOURCE BUFFER *COMPILE, LIST, SOURCE* 

DISPLAY DEVICE CODES *DEVICES* 

DROP MALET PPU AND CPU 

DUMP RANDOM FILE TO BINARY FILE *DUMP* 

RESUME EXECUTION OF MODULE THAT WAS STOPPED *GO* 

SET LINE FOR NEXT ENTRY *LINE=NNN* 

LIST N LINES ON OUTPUT FILE. *LIST NN* 

LOAD MODULE *LOAD MNENN* 

DISPLAY MALET EXECUTIVE DIRECTIVES *MALET* 

DISPLAY MODULES CURRENTLY ON RANDOM FILE *MODULES* 

*MOVE AAA UP BBB LINES* 

*M0VE AAA DOWN BBB LINES* 

COMMENTS 

CHANGES PARAMETERS *PARAM PO=1234,Pl=1234,P9=1234, 

TL=1234,LL=1234* TL=PPU TIME LIMIT LL=LINE LIMIT 

PRINT K/L DISPLAY ON OUTPUT FILE *PICTURE=TYPE* 

DISPLAY PPU MESSAGES/PLOTS *PPU* 

PUNCH SOURCE BUFFER *PUNCH* 

PURGE X FROM RANDOM FILE 

RUN MODULE(S) *RUN MNE (01,02,03,04,10,07)* 

CHANGE SCRATCH FILE NAME *SCRATCH=LFN* 

SEND MESSAGE TO B DISPLAY *SEND, CONTENT OF MSG* 

SET DS REGISTER SWITCHES *SETDS,SE,RM,RT,RC* 

SET- SWITCHES *SETSW,PL,DL,SE,RM,RT,SB,KL,RC* 

DISPLAY SOURCE FOR MODULE *SOURCE* 

STOP PPU EXECUTION USED ONLY ON K/L DISPLAY 

ADVANCE PAGE ON K/L DISPLAY 

DECREMENT PAGE ON K/L DISPLAY 



LINE=000 



PPU STATUS = STOPPED MODULE = TSTOl 



Figure 2-6. Sample K/L Display for MALET Directive 



MODULES Directive 

Display a listing of modules in the random file. 



MODULES 
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Description: 

The MODULES directive displays a list of modules currently existing in the random file 
(refer to figure 2-7). Modules which are preceded by an asterisk are identified as 
containing assembly errors . 



MALET - MAINTENANCE APPLICATION LANGUAGE FOR EQUIP. TESTING 



LINE=000 



MODULES ON RANDOM FILE 



TSTOO 


TST02 


TST03 


TST04 


TST05 


TST06 


TST07 


TST08 


TST09B 


TST10 


TST11 


TST12 


TST13 


*TST14 


TST15 


TST16 


*TST17 


TST18A 


TST19 


TST20 


TST21 


TST22 


*TST23 


TST24 


TST25 


TST26 


TST27 


TST28 


TST290 


TST291 


TST31 


TST32 


TST33 


TST34 


TST35 



PPU STATUS = STOPPED 



MODULE = TSTOO 



Figure 2-7. Sample K/L Display for MODULES Directive 



MOVE or M Directive 

Move source code lines . 



' MOVE 


aa 


UP bb 


MOVE 


aa 


- bb 


M 


aa 


UP bb 


M 


aa 


- bb 


MOVE 


aa 


DOWN bb 


MOVE 


aa 


+ bb 


M 


aa 


DOWN bb 


M 

V 


aa 


+ bb 

aa 
bb 


60455980 


T 





First line number to be shifted. 
Number of line positions shifted. 
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Description: 

The MOVE or M directive moves source lines either up or down within the source code buffer. 
It is normally used to make space for modifications within a module and eliminate unwanted 
lines. A move up overwrites the data on the lines to which the move is made. A move down 
eliminates the lines that shift past the end of the module buffer. The plus (+) and minus 
(-) characters can be substituted for UP and DOWN. 

PARAM or P Directive 

Display and alter parameters passed to the PP registers. 



PARAM P0=aa,Pl=bb,P2=cc,P3=dd,P4=ee,P5=ff ,P6=gg,P7=hh,P8=ii,P9=jj ,LL=rr ,TL=ss 
P PO=aa,Pl=bb,...,LL=rr,TL=ss 

aa,bb,...,jj Value to be placed in the specified parameter register. 

rr Number of executed lines allowed to be transmitted to the output 

file before MALET displays the line limit GO/DROP message; no 
default. 

ss Number of seconds the PP driver is allowed to execute before 

being forced to stop; default=5. The TL parameter is used only 
if operating in the terminal mode. A stop is sent to the module 
every TL seconds to allow the user to issue a terminal interrupt 
(CONTROL T under NOS) and read an input. If no terminal 
interrupt is pending, a resume execution is automatically issued 
for the module by the executive. 



Description: 

The PARAM directive changes specified parameters and/or lists current parameters to the 
display. Supplying no parameters in the command format causes only the display to be listed. 

Method of Execution: 

Program parameters are passed to the PP driver as a module is brought into execution with a 
RUN directive. The K/L display changes to the parameter display when the PARAM directive is 
processed (refer to figure 2-8). 

Restrictions: 

The upper 4 bits of hexadecimal entries can only be accessed by product overlays which 
support 16-bit parameter entries such as LCN. 
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MALET - MAINT . APPLICATION LANGUAGE FOR EQUIP . TESTING 



PO = 0000 
P3 = 0000 
P6 = 0000 
P9 = 0000 



PARAMETERS 

PI = 0000 
P4 - 0000 
P7 = 0000 
TL = 0005 



P2 = 0000 
P5 = 0000 
P8 = 0000 
LL = 1750 



SWITCH STATUS 



ON - (SE) STOP ON ERROR 

OFF - (RT) REPEAT TEST 

ON - (PL) PRINT LOG 

OFF - (KL) K/L DISPLAY 



OFF - (RM) REPEAT MODULE 

OFF - (SB) STANDBY PPU FOR I/O 

ON - (DL) DAYFILE LOG 

OFF - (RC) REPEAT CONDITION 



ASSIGN VALUES 
DC=0000 EST=0000 CH=0000 EQ=0000 UN=0000 AL=0000 



ADDITIONAL ASSIGN VALUES 

SN=000000 SHARE=N0 SCRATCH=SCRATCH 

LTA=0000 TCU=0000 AC=0000 BFZ=0000 



DS REGISTER SWITCH STATUS 



ON 
OFF 
OFF 

OFF - (BT) 
OFF 
OFF 



(SE) STOP ON ERROR 
(RM) REPEAT MODULE 
(BC) BEGINNING OF COND 
BEGINNING OF TEST 
(CE) CONDITION END STOP 
(SI) PROGRAMMABLE SW 1 



OFF - (RT) REPEAT TEST 

OFF - (RC) REPEAT CONDITION 

OFF - (BM) BEGINNING OF MODULE 

OFF - (TE) TEST END STOP 

OFF - (ME) MODULE END STOP 

OFF - (S2) PROGRAMMABLE SW 2 



LINE=000 



ADDITIONAL ASSIGN VALUES FOR MSS ONLY 

MSA=0 MSAID=00 C=00/00 
CSU=0 CSUID=00 
MST=0 MSTID=00 
MSTPH=0 

PPU STATUS = STOPPED MODULE = 



Figure 2-8. Sample K/L Display for PARAM Directive 
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PICTURE Directive 

Send a picture of the K/L display to the 



output file. 



PICTURE SOURCE, PARAM, DEVICES ,MALET, PPU, MODULES 


SOURCE 


Print a listing of SOURCE data (refer to figure 2-9 later in 




this section). 


PARAM 


Print a picture of the PARAM display (refer to figure 2-8). 


DEVICES 


Print a picture of the DEVICES display (refer to figure 2-5). 


MALET 


Print a picture of the MALET display (refer to figure 2-6). 


PPU 


Print a picture of the PPU display. 


MODULES 


Print a picture of the MODULES display (refer to figure 2-7). 



Description: 

The PICTURE directive sends a copy of the specified display (s) to the output file. If 
no parameter is specified, the current K/L display is sent to the output file. 



NOTE 



When running MALET from a remote terminal, 
use PICTURE PPU to check the PP for possible 
additional error information. 
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PPU Directive 

Display PP messages/ plots . 




Description : 

The PPU directive displays PP information on the K/L display. 

PUNCH Directive 

Copy current source code to the local file PUNCH. 




Description : 

The PUNCH directive copies information from the source code buffer into the PUNCH file. 

PURGE Directive 

Delete a module from the random file. 



PURGE MNEnnn 




MNE 


Three letter mnemonic for module test series. 


nnn 


Module number. 
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Description: 

The PURGE directive purges the specified module from the random file. 

Restrictions: 

If no module number (nnn) is specified, all modules which begin with MNE are deleted. 

The PURGE directive only deletes the module name from the index. To remove the binary it is 
necessary to dump the modules to the binary file, return to RFILE, and reload the modules. 

RUN or R Directive 

Execute a MALET module in the PP driver. 



RUN MNE 




RUN MNE(aaa,bbb,.. . ,nnn) 




R MNE 




R MNE(aaa,bbb nnn) 




MNE 


Three letter mnemonic for the module test 




series. 


aaa , bbb , . . . , nnn 


Module numbers . 



Description: 

The RUN or R directive initiates module execution. The format of the directive can specify: 

• A test series. 

• Particular modules within a test series. 

• Order in which modules are to be run. 
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The following examples demonstrate features of the directive. 

Example 1: Run modules 00 through 34 in specified order regardless of END/EXIT statements. 

RUN MNE(00, 01, 02, 03, 04, 05, 06, 07,..., 29, 30, 31, 
32,33,34) 



NOTE 



The right parenthesis is not present on the 
first line of the entry. The directive 
automatically continues reading module 
numbers from the second line until the right 
parenthesis is encountered. 



Example 2: Run modules 00 and 01 twice regardless of END/EXIT statements. 

RUN MNE(00,01,00,01) 
Example 3: Run test series MNE beginning with the lowest numbered module. 

RUN MNE 
Example 4: Run test series MNE beginning with module 20. 

RUN MNE20 
Example 5: Run only test module 20. 

RUN MNE(20) 
Example 6: Run lowest numbered module of currently loaded test. 

RUN 

Restrictions : 

• When only the test series is specified (MNE), the test modules execute in numerical 
order. Testing stops following each module in which an END command is encountered; 
it is resumed with a GO directive. 

• Leading zeros are necessary when specifying module numbers. 

• If more than 60 characters are required to specify a module test sequence, a right 
parenthesis should only appear following the last module of the sequence. 

• A maximum of 100 modules can be specified on one RUN or R directive. 
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SCRATCH Directive 

Change the name of the SCRATCH file. 



SCRATCH=name 



File designated as the scratch file. 



Description: 

The SCRATCH directive designates the indicated file as the scratch file to be accessed by 
SYSRD/SYSWR/SYSREW commands. 



SEND Directive 

Send a message to the B display and output file. 



SEND message 




message 


Character string to be delivered to B display and 




output file. 



Description : 

The SEND directive copies the accompanying message to both the B display and the output file. 

Restrictions: 

On NOS at PSR level 528 or higher, and on all NOS/BE operating systems, the message flashes 
on the B display awaiting an operator x.GO command (x is the control point). The message 
does not flash on NOS below PSR level 528 but it still requires the x.GO command. After the 
x.GO command is issued, an OPERATOR GAVE GO message appears on the B display and is entered 
in the print file, which appears at the remote terminal. 
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SETDS Directive 

Enable switch options in the DS register. 



SETDS SE, RM,RC,BC,BM,BT,TE,CE,ME,S1,RT,S2 

SE Stop on error; default=ON. 

RM Repeat module; default=OFF. 

EC Repeat condition; default=OFF. 

BC Beginning of condition stop; default=OFF. 

BM Beginning of module stop; default=OFF. 

BT Beginning of test stop; default=OFF. 

TE End of test stop; default=OFF. 

CE Condition end stop; default=OFF. 

ME Module end stop; default=OFF. 

51 Programmable switch 1; default=OFF. 
RT Repeat test; default=OFF. 

52 Programmable switch 2; default=OFF. 



Description : 

The SETDS directive sets specific switch options in the DS register to ON. The DS register 
switches are referenced by modules executing remotely in devices such as LCN and FSC. 
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SETSW Directive 

Enable switch options in the ES register. 



SETSW RC.SE.RM.PL.DL.RT.KL.SB 

RC Repeat condition; default=OFF. 

SE Stop on error; default=ON. 

RM Repeat module; default=OFF. 

PL Print log; default=ON. 

DL Dayfile log; default=ON. 

RT Repeat test; default=OFF. 

KL System K/L display; default=OFF (Illegal from terminal), 

SB Standby PP option; default=OFF. In this mode the PP 

driver is not assisted in escaping an I/O channel hang. 



Description: 

The SETSW directive sets specific switch options in the ES register to ON. The ES register 
switches are referenced by modules executing in a PP. 



SOURCE Directive 

Display a page of the source code buffer. 



SOURCE 



Description: 

The SOURCE directive displays a page of the source code buffer (refer to figure 2-9). The 
(+) and (-) directives can be used to page through the source code buffer. 



2-36 60455980 T 



MALET - MAINTENANCE APPLICATION LANGUAGE FOR EQUIP. TESTING 



000= MODULE TST01, 3000(20, 21, 22) 

001=01 FORMAT SAMPLE MODULE TO DISPLAY MSGS ON LINE=*OCT 

002=02 B2=0 

003=03 B1=0 

004=04 MSG 1(B1) to LINE Bl 

005= GOTO 4 WHILE (Bl+l.NE .5 IB) 

006= GOTO 3 WHILE (B2+1.NE.100B) 

007= END 2 

010= 

011= 

012= 

013= 

014= 

015= 

016 = 

017= 



045= 

046 = 

047 = 



LINE=010 PPU STATUS = STOPPED MODULE = TST01 



Figure 2-9. Sample K/L Display for the SOURCE Directive 
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STOP or S Directive 

Stop execution of a MALET module. 



STOP 



Description: 

The STOP directive halts execution of a MALET module in the PP driver. 

Method of Execution: 

The STOP directive sets the PP stop switch and sends it to the PP driver. The PP 
checkpoints the currently executing module at the next logical breakpoint and drops, 

+ Directive 

Move display one page forward. 



Description: 

The + directive moves the existing K/L display one page forward. 

- Directive 

Move display one page backward (23 or 40 lines, depending on system version). 



Description: 

The - directive moves the existing K/L display one page backward (23 or 40 lines, depending 
on system version). 
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INPUT/OUTPUT CONFIDENCE LEVEL TESTS 



TIO 

TIO is a confidence level test designed to provide an on-line check of I/O operations and to 
assess the performance of the mass storage devices, tapes, and disks on CYBER 70, CYBER 170, 
CYBER 180, and 6000 Computer Systems. Testing is performed through the use of FORTRAN 
Extended statements BUFFERIN, BUFFEROUT, REWIND, ENDFIL, and BACKSPACE. FORTRAN I/O 
subprograms used are UNIT and LENGTH. The test is composed of two sections. The first is 
the sequential section in which the device is tested by sequentially writing and reading 
patterns of preset and random lengths. The second is the random section in which the device 
is tested by performing random operations with random data of random lengths. 



OPERATING PROCEDURES 

TIO is a control card callable program requiring parameters selecting the operation and 
functions to be performed. 



PARAMETERS 

SEQ=N 

Defines the decimal number of sequential records to be written on the test file(s) 
during the sequential section. If SEQ=0, the sequential section is skipped. 
Default is 200. The maximum value for N is 9999999. 

RAN=N 

Defines the decimal number of random operations to perform during the random 
section. If RAN=0, the random section is skipped. Default is 1000. The maximum 
value for N is 9999999. 

FILES=N 
FILES=LFN1/LFN2/LFN3/LFN4/LFN5 

FILE=N where N is the value 1 through 5 used to turn on N test file(s) with default 
logical file name(s): TAPE1, TAPE2, TAPE3, TAPE4, and TAPE5. The alternate form of 
this parameter is used if the user wishes to turn on the test file(s) and change the 
logical file name(s) from the default. Default of FILE is 1 and FILES is TAPE1. 

0UTPUT=LFN 
0=LFN 

Used to change the logical file name of the output file. Default of OUTPUT is 
OUTPUT and is OUTPUT. 
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PASSES=N 



Defines the decimal number of passes that the sequential and random sections 
execute. One pass includes both binary and coded modes if the mode parameter is not 
used. When the mode parameter is used, one pass consists of the selected mode. 
Default is 3. The maximum value for N is 9999999. 



LIST=N 



The value for N is the decimal number of errors to be written to the output file 
before terminating. Default is 100. The maximum value for N is 9999999. 



MAXREC=N 



N equals the maximum record length to be written on the test file(s) in 60-bit 
central memory words. Default is 2000. The maximum value for N is 2000. 

MINREC=N 

N equals the minimum record length to be written on the test file(s) in 60-bit 
central memory words. Default is 1. The minimum value for N is 1. 

PATTERN=NN/AAAA/BBBB/CCCC/DDDD/EEEE 
PAT=NN/AAAA/BBBB/CCCC/DDDD/EEEE 

The pattern parameter is used if a certain pattern is desired for the data written 
on the test file(s). The value for NN can be any number from 1 through 59 decimal 
and defines the number of bits to be used in the pattern. The values for AAAA 
through EEEE must be four octal digits, right-justified, representing the pattern 
desired. For example: 

• PAT=12/3210 stores 321032103210 throughout the write buffer. 

• PAT=6/0012 stores 121212 throughout the write buffer. 

• PAT=30/0012/3456/7077 stores 123456707712345 throughout the write buffer. 

• PAT=8/0376 stores 775773767757737 throughout the write buffer. 

To force random data for the sequential section, use PAT=RAN, PAT=RAND0M, 
PATTERN=RAN, or PATTERN=RAND0M. Default is PRESET/RANDOM. 

When operating in the coded (BCD) mode, all 00B characters are replaced by 33B; if 
byte 4 of a 60-bit word is 6362B, it is replaced by 3333B. 

HIST0RY=N 

If present on the call statement, T10 lists up to the last decimal N operation 
performed on the test file(s) preceding an error. If N is greater than 50, all of 
the operations listed are listed on the output file. Default is 0. 

WRITE 

Used to run the sequential section in a write-only mode to create test file(s). The 
test file(s) can be used in another run of TIO through the use of the READ 
parameter. The random section is disabled if this parameter is used. The mode 

narampi" or must- h*s iiRfarl "if rnde*r\ f-^fit* fnlfaffi^ ir HscirpH. D* 3 "f *" 1 1 *" tb OFF- 
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READ 



Used to run the sequential section in a read-only mode on test file(s) prewritten 
through the use of the WRITE parameter. The random section is disabled if this 
parameter is used. The mode parameter must be used if the test file(s) is in coded 
format. Default is OFF. 



MODE=BCD 
MODE=BIN 



Used to select coded or binary mode where BCD is coded and BIN is binary. Default 
is both used. 



SAMPLE JOBS 

Example 1: This job runs TIO default parameters. 

JOB/USER/ACCOUNT CARDS. 

REQUEST, TAPE 1. 

TIO. 

6/7/8/9 

Example 2: This job runs 10 passes of the sequential and random sections with record 
lengths of 10 words and lists all errors on a file called SCRATCH. 

JOB /USER/ ACCOUNT CARDS. 
REQUEST, TAPE 1. 

TIO(0=SCRATCH,PASSES=10,MINREC=10,MAXREC=10) 
6/7/8/9 

Example 3: This job runs the sequential and random sections on a TAPE22, in binary mode and 
terminates if 10 errors are test file, encountered or end of test is reached. 

JOB /USER/ACCOUNT CARDS. 
REQUEST, TAPE22. 

TIO(FILES=TAPE22,LIST=10,MODE=BIN) 
6/7/8/9 

Example 4: This job runs the sequential and random sections of five system scratch test 

files and lists all of the operations on the output file. The output provided 
by this job is large. 

JOB /USER/ ACCOUNT CARDS. 
TIO (FILES-5 ,HISTORY=ALL ) 
6/7/8/9 

Example 5: This job performs a write operation only, with a pattern of all ones in binary 
mode and loops for the default number of passes. 
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JOB/USER/ACCOUNT CARDS. 
REQUEST, TAPE 1. 
TIO(PAT=12/777, WRITE) 
6/7/8/9 

Example 6. This job reads TAPE1 created in job 5 and reports any data errors encountered 
with the ones pattern. 

JOB /USER/ACCOUNT CARDS. 
REQUEST, TAPE1. 
TIO(PAT=12/7777,READ) 
6/7/8/9 

Example 7: This job runs the sequential and random sections writing and reading a pattern 
of 00200400100 octal on default system scratch file TAPE1, and reports the last 
five operations preceding any error encountered. 

JOB /USER/ACCOUNT CARDS. 

TIO(PAT=8/0020,HISTORY=5) 

6/7/8/9 



PARAMETER ERROR MESSAGES 

UNRECOGNIZED PARAMETER... (parameter) 

Unrecognized parameter on call statement. 
UNRECOGNIZED PARAMETER. . . (PARAMETER=parameter ) 

Unrecognized parameter on call statement. 
DECIMAL CONVERT ERROR PARAMETER. .. (PATTERN=A/ 1234) 

Value for A must be decimal. 
VALUE TOO HIGH PARAMETER. .. (FILES=6) 

Value is above maximum allowed for parameter. 
OCTAL CONVERT ERROR PARAMETER. .. (PATTERN=60/ALPHA) 

Alpha value must be octal. 
MAXREC=1999 MINREC=2000.. .MAX LESS THAN MIN 

Maximum cannot be less than minimum. 
...PROGRAM ABORT... BAD PARAMETERS... 

One or more parameter errors on control card (refer to output). 
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VALUE TOO LOW PARAMETER.. .(FILES=0) 

Value is below minimum allowed for parameter. 
NO SECTION SELECTED (SEQ=0, RAN=0) 

User must select at least one section. 
FILE NAME ABC=ABC DUPLICATE NAMES 

Two file names are the same on either the FILES or OUTPUT parameters. 

SEQ AND RAN ERROR MESSAGES 

In the following error messages, the alphabetic codes used are: 
R Record number. 
L Record length. 
W Word number. 
E Expected data. 
A Actual data. 
D Difference. 

SEQ PASS=000l TAPE1 BIN PARITY ERR R=0001 L=2000 
SEQ PASS=0001 TAPE2 BCD DATA ERR R=0001 W=1999 E=X D=X 

X Twenty octal digits. 
SEQ PASS=0002 TAPE1 BIN EOF EXPECTED R=0002 L=0 
SEQ PASS=0003 TAPE2 BCD EOF NOT EXPECTED R=0002 L-2000 
RAN PASS=0001 TAPE5 BIN LENGTH ERR R=0001 E=2000 A=1999 
RAN PASS=0002 TAPEl BCD GT 10 DATA ERRS R=0002 
RAN PASS=0002 TAPE2 BIN M/R CMP ERR R=0002 M=X R=Y 

X Twenty octal digits of the model word. 

Model word 12/FWA of write, 12/record length, 36/record number. 

Y Twenty octal digits of the record word. 

Record word 12/FWA of write, 12/record length, 36/record number. 
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ERRORS EXCEED LIST = OO0O1O RUN ENDED 

SEQ PASS=0002 TAPE1 BIN REC-NO ERR E=0002 A=0003 CONT. BY 
SETTING E=A 

Record number read does not match internal model so TIO attempted recovery by 
setting expected record to actual. 

SEQ PASS=0002 TAPE1 BIN REC-NO ERR E=0003 A=0001 CAN NOT 
CONTINUE 

Record number read does not match expected value and correction would not work. 
Program calls EXIT. The following message is entered in the dayfile. 

REC NUMBER ERR UNRECVD . . CALL EXIT 



INSTALLATION DECK 

Refer to CML Installation in section 1. 

TEST FILE RECORD FORMAT 

The first 60 bits of data form a control word containing the first word address of the 
output from the write buffer, record length, and record number as follows: 

5 4 3 2 1 

987654321098765432109876543210987654321098765432109876543210 

*--FWA ** LENGTH—** RECORD NUMBER * 

Data is checked by comparing the data in the read buffer with the data in the write buffer. 
If a record has more than 10 errors, further data checking on that record is ended with the 
message: 

GT 10 DATA ERRORS 



4-6 60455980 N 



REGEN 

REGEN is an on-line confidence test program written in the FORTRAN Extended language and 
designed to run on the CYBER 70, CYBER 170/180, and 6000 Series Computer Systems. Its two 
major functions are to provide validation of system data paths by passing checksummed data 
across selected data paths and verifying that data does not deteriorate due to hardware or 
software errors, and to verify that the central processor and central memory units can 
execute diagnostic tests FST and ALX, producing answers that agree with a master data base 
of answers. Any answers detected are entered into an error log assigned as TAPE99. 

Although REGEN is normally run as a user job concurrently with other user jobs, it can be 
used more effectively in a dedicated system where several copies of REGEN are the only^ 
jobs. This allows validation of the total system under voltage of clock margins or while 
shocktesting. 

REGEN can operate in any one of six basic modes selected by data cards in an input file. 
The modes are: 

Generate mode Generate a data base on a disk or tape file. 

Copy mode Copy a data base from one file to another. 

Regenerate mode Regenerate a data base and compare it with a previous data base file, 

Return mode Return a file (close/unload). 

Runpass mode Run a specific pass of diagnostic tests FST and ALX and print the 
results. 

Isolate mode Analyze an error log from a previous REGEN run that had errors. 

In selecting a specific mode, a distributor routine reads the input card deck and makes the 
selection. The selected mode, using FORTRAN Extended, calls and supplies parameters to six 
COMPASS subroutines used to accomplish the tasks of the various modes of operation. Refer 
to figure 4-1. 
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Figure 4-1. REGEN Modes 
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Subroutine PVC (parity vector checksumming) is a high-speed checksum program that generates 
the checksum of data blocks of any length. It generates a three-word checksum for each 60 
words or less of input data: straight-line, left-diagonal, and right-diagonal logical sums 
(figure 4-2). This technique allows isolation of a single bit failure to the word and bit 
that failed. The code is ultrafast, providing checksumming capability on the model 74 at 
about 1.5 microseconds per checksummed word. 

Subroutine INIT is used to reestablish the starting base numbers for a specific pass of 
subroutines FST and ALX. This allows the re-creation of specific passes that are identical 
to previously run passes. 

Subroutine FST is designed to run random instructions back-to-back in a conflicting mode and 
then spaced apart in a nonconf licting mode. FST then determines if any variations in 
results occurred (figure 4-3). 

Subroutine ALX is designed to run at a maximum instruction issue rate by first running in 
the instruction stack and then at a slower out-of-stack mode. ALX then determines if any 
variations in answers occurred (figure 4-4). 

Subroutine RT is used to calculate wall-clock timing for each operation and the total run. 

Subroutine UNLOAD is used to rewind and unload a file. This releases the unit or disk space 
for other operations after a data path has been validated. 
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Figure 4-2. PVC Checksumming 
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Figure 4-3. FST Flowchart 
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Figure 4-4. ALX Flowchart 
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MODES OF OPERATION 

Following are the modes of operation for the REGEN program. 



Generate Mode 

The generate mode, shown in figure 4-5, is provided to build an initial master data base. 
To check compatibility between sites in a network, only one site should run the initial 
generate. Copies of the master data base should then be made using the copy mode to build 
data base copies for all other sites in the network. 

In building the master data base, one pass each of FST and ALX is run. This tests the 
central processor and central memory and provides 60 words of resultant data as follows: 



Words 1 through 16 
Words 17 through 32 
Words 33 through 48 
Words 49 through 53 
Words 54 through 59 
Word 60 



FST fast loop answers (exchange package format), 

FST fast loop instructions. 

ALX fast loop answers (exchange package format). 

ALX fast loop instructions. 

ALX random operands. 

ALX pass count +1 . 



Subroutine PVC is then called to generate a three-word checksum (straight-line, 
left-diagonal, and right-diagonal) of these 60 words to represent this pass. This procedure 
is repeated 20 times until 60 words of checksums have been generated. Subroutine PVC is then 
called again to generate a three-word checksum of the checksums for a total of 63 words. A 
64th word, called the position data word, is added which identifies the job name, file 
number, record number, and block number for this particular block. This word is constructed 
as follows: 



Bits through 2 
Bits 3 through 14 
Bits 15 through 23 
Bits 24 through 59 



Block number (1 through 7). 

Record number (1 through 7246B). 

File number (1 through 32) that represents tape 1 through 32, 

Unique job name identifier supplied by the user on the first 
input card. 



The total process is repeated eight times to generate a block of 512 words; 511 of these 
words are then written to tape x as a record. The last position data word is not written. 

The entire process is repeated the number of times requested on the first data card to 
REGEN. A maximum of 3750 records fills a 2400-foot reel of tape at 800 bpi. 
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Figure 4-5. Generate Mode Flowchart 
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Copy Mode 

The copy mode, shown in figure 4-6, verifies an input data path, and creates a copy of the 
master data base on the same or another device in the system. Normally, the copy created in 
this mode is verified on a subsequent copy or when in the regenerate mode. 

A 511-word record is read from tape n, specified on an input data card to REGEN, as the one 
containing the master data base and copied to another tape nn. Prior to writing this 
record, a number of validation checks are made to ensure that the data has not been 
deteriorated by the hardware or software. On all reads of a data base, the following checks 
are made. 

Parity error status check 

If the system returns control to REGEN after detecting a parity error, a backspace 
reread is performed once. If the error persists, the job is aborted. 

End-of-file status check 

If an end-of-file status is detected, it indicates that the data base does not 
contain the expected number of records requested by the first input data card to 
REGEN. In this case, the job is aborted. 

Record length check 

The record length is checked. If it does not contain 511 words, a backspace-reread 
is performed. If the error persists, the job is aborted. 

Data check 

Data is checked to ensure that it belongs to the current job, is in the correct 
record-number sequence, and that the blocks (or sectors, in the case of mass 
storage) are also in the correct sequence. This check is performed by validating 
the seven position data words within the record. Up to six retries can be made to 
correct a record that fails these tests. 

An in-core retry of the test is performed to ensure that is is not a transient CPU 
error. 

A backspace-reread to the same buffer is performed to determine if it is a transient 
I/O network error. 

A backspace-reread to a second buffer in central memory is performed to determine if 
the error is central memory address sensitive. Buffers 1 and 2 first word addresses 
are staged one word off from each other so that a central memory bank failure brings 
the detected failure to a new address when switching from buffer 1 to buffer 2. 
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Figure 4-6. Copy Mode Flowchart 
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NOTE 

The previous process could correct a 
position data error since it is only one 
word in length. However, a checksum data 
error could follow since it is possible to 
move data into the bad bank, addresses. Once 
a switch is made from buffer 1 to buffer 2 
on a record due to an error, the program 
stays in that buffer until the record is 
processed. The next record is processed out 
of buffer 1. Buffer 1 is always used in the 
generate mode. Buffer use in the copy or 
regenerate modes is dictated by error 
situations. 

An in-core retry of buffer 2. 

A backspace/reread to buffer 2. 



Retries are attempted only until a recovery has been successfully completed or until 
all options have been tried without success, in which case the job is aborted. On 
each failure, the data in question is printed for customer engineering analysis, and 
an error log is written to a file called tape 99 for later and more detailed 
analysis during a run of the isolate mode. Data is also printed after a recovery to 
provide the customer engineer with correct data to compare with bad data previously 
written. If it is not possible to effect a recovery and all errors are identical, it 
can be assumed that the data being read was written incorrectly. 

The checksums of all eight blocks are validated by subroutine PVC. Six retires are 
possible in case of error and are identical to those used on position data errors. 
In all cases, if a reread is performed to recover a specific block error, the reread 
could destory a previously validated block. Therefore, all position data and 
checksum words must be revalidated after recovery if a reread has been performed. 

If all these checks are successful, new position data is inserted into the data read 
from tape x and the 511 words are written to tape xx. New position words must be 
added to ensure that the job name identifier supplied for this run on the first 
input data card to 

REGEN is carried with the file. The process of reading, validating, and writing is 
repeated for the number of records specified on the first input data card to REGEN 
(number of records to process). 



Regenerate Mode 

The regenerate mode, shown in figure 4-7, accomplishes two tasks. 



• 



It verifies an input data path in the same manner as in the copy mode (parity, 
length, position, and checksums). The file number is specified on the input data 
cards to REGEN. 
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Figure 4-7. Regenerate Mode Flowchart 
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• It tests the central processor and central memory units by running FST and ALX, 

calling subroutine PVC to generate checksums of answers of each pass and comparing 
them to the checksums read across the input data paths. 

After a record of 511 words has been read and validated, each block of this record is 
regarded as 20 three-word checksums that represent the checksums of 20 passes of FST/ALX. 
Therefore, 20 passes of FST/ALX are run before a block is used up. This process is repeated 
eight times to use up a total record representing 160 passes of FST/ALX per record. The 
process of reading a record, validating a record, and running FST/ALX/PVC to test the 
central processor and central memory is repeated the number of times specified by the number 
of records to process given on the first input data card to REGEN. 



Return Mode 

The RETURN command rewinds tape x and calls a COMPASS subroutine UNLOAD to perform a 
close/unload operation. This releases a physical tape unit for use by another job in the 
system or releases disk space for use by either REGEN or another job in the system. 



Runpass Mode 

Runpass is not a test. It is a maintenance aid designed to aid a customer engineer in 
determining more about a failure on a previous REGEN job where FST/ALX failed to re-create 
the expected checksums of a particular pass in the regenerate mode. When this type of error 
occurs, all that is known is the current data generated by FST/ALX, the current checksums of 
that data, and the expected checksums. There is no way of knowing the correct data that 
FST/ALX should have generated on this pass for checksumming. 

RUNPASS provides this data by initializing FST/ALX to the pass requested on the input data 
card to REGEN. Following the pass, PVC is called to generate a three-word checksum of this 
data. The results are then printed. 



.■v^**'^**'*^ * 



CAUTION 



If the same system is used to run this task, 
it could fail in the same way as the 
previous run of REGEN. If this happens, SMM 
off-line diagnostics should be used to 
verify system operation. 



Isolate Mode 

Isolate is another maintenance aid within REGEN that aids the customer engineer in 
determining more about the characteristics of a failure in a previous REGEN run. Its 
function is to process the tape 99 error log generated by a previous REGEN job in which 
errors were detected. 
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Isolate requires two tape files specified on an input data card. One file must contain a 
good copy of the master data base, and the other file must contain the error log from a 
previous REGEN run. 

Isolate rewinds both tapes and searches the master data base for records that are on the 
error log. Once found, the two records are compared, and any noncompare words are printed. 
The raw error log, generated by a REGEN job, can have records out of sequential order 
relative to the master data base. Therefore, it is advisable to run the raw error log 
through a sort/merge phase before running the isolate mode. If SORTMERGE is not available 
on site, Isolate detects that the records are out of sequence. It then rewinds the master 
data base file and restarts the search. If there are many errors in the error log, this 
action could be time-consuming. 



OPERATING PROCEDURES AND EXECUTION DESCRIPTION 

Program REGEN is control card callable; the first card of the input deck must contain a 
unique job identifier consisting of alphabetic characters in columns 1 through 6. This card 
must also contain the number of records (in decimal) to be processed right- justified in 
columns 8 through 11. 

The various REGEN modes of operation are selected by input data cards as shown in table 
4-1. All cards begin in column 1. 



Table 4-1. Input Control Cards (Sheet 1 of 2) 



Control Card 


Description 


GENERATE xx 
COPY xx yy 

REGENERATE xx 


Select generate mode and 
generate a master data base on 
tape xx. xx is any decimal 
number representing tapes 1 
through 32, xx begins in 
column 12, right justified. 

Select copy mode and copy tape 
xx to tape yy. xx is the 
input file number (1 through 
32) representing tapes 1 
through 32, and yy is the 
output file number (1 through 
32). xx begins in column 12 
and yy begins In column 15, 
both right justified. 

Select regenerate mode and use 
the data base on tape xx. xx 
is the input file number 
representing tapes 1 through 
32. xx begins in column 12, 
right justified. 
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Table 4-1. Input Control Cards (Sheet 2 of 2) 



Control Card 


Description 


RETURN xx 
RUNPASS xxxxxxx 

ISOLATE xx yy 


Select return mode to rewind, 
close, and unload tape xx. xx 
begins in column 12, right 
justified. 

Select runpass mode and run 
FST/ALX for pass requested by 
xxxxxxx. xxxxxxx is an octal 
pass number between and 
2223677. xxxxxxx begins 
in column 12, right justified. 

Select isolate mode to obtain 
a good copy of the master data 
base at file number xx. xx is 
a number between 1 and 32. yy 
is the tape number between 1 
and 32 containing the error log 
of a previous REGEN run. xx 
begins in column 12, and yy 
begins in column 15; both are 
right justified. 



SENSE SWITCHES 

REGEN uses three sense switches to control job execution and error reporting. 

Sense switch 1, when set, causes REGEN to terminate at the end of the 
current mode regardless of the modes remaining in the input file. 

Sense switch 2, when set, causes REGEN to pause after each of the following 
error situations. 

Pause 1 Read parity error. 

Pause 2 Read length error. 

Pause 3 Position data error. 

Pause 4 Checksum data error on input data. 

Pause 5 First try checksum error on FST/ALX data during regenerate 
mode. 

Pause 6 The in-core retry of the checksum operation on the FST/ALX 
data. 

The pause message number and dayfile message issued prior to the pause 
allows the user to determine the nature of the pause. An operator GO 
command is required to continue processing. 
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Sense switch 3 is used to control the amount of data that is printed on each failure 
analyzed during the isolate mode. If this switch is off, only the first 10 words in error 
within each record are printed. If the switch is on, all noncompare words are printed and 
could result in over 511 lines per record in error. 



SAMPLE JOBS 

The following sample jobs illustrate the use of program REGEN and how the various modes are 
called. 

Example 1: This job generates a master data base of 3750 records to be used as the site 
master copy. Use the job name of MASTER. 

JOBCARD 

ACCOUNT and RESOURC cards as required 

REQUEST, TAPE 1. Magnetic tape request card for 

M0DE,1. data base. 

REGEN. 

EXIT. 

DMP, 10000. 

7/8/9 

MASTER 3750 

GENERATE 01 

6/7/8/9 



In case of an FST/ALX error. 



Example 2: This job copies tape 1 to tape 2 to tape 3 to tape 4 and regenerates data on 

tape 4. Process 500 records with job name of J0B2. The master data base is on 
tape 1; therefore, a REQUEST card must be be included that properly identifies 
it. The files for tapes 2, 3, and 4 can reside anywhere on tape or disk as the 
user desires. 



JOBCARD 

ACCOUNT, and RESOURC cards as required. 

REQUEST cards to specify the path to tapes 1 

through 4. 
REQUEST, TAPE99. Magnetic tape request card for 
error log. 



In case of an FST/ALX error. 



M0DE.1. 




REGEN. 




EXIT. 




DMP, 10000. 




7/8/9 




J0B2 0500 




COPY 01 


02 


RETURN 01 




COPY 02 


03 


COPY 03 


04 


REGENERATE 04 




6/7/8/9 





4-22 



60455980 G 



Example 3: This job executes a runpass of FST/ALX to pass number 0000123. 

JOBCARD 

ACCOUNT and RESOURC cards as required. 

MODE.1. 

REGEN. 

EXIT. 

DMP, 10000. In case of an FST/ALX error. 

7/8/9 

J0B3 

RUNPASS 0000123 

6/7/8/9 

Example A: This job executes an isolate mode against an error log from a previous REGEN 

job. Sort/Merge is in the system, so sort the error log from tape 99 to tape 2 
before presenting it to REGEN. The master data base is on tape 1. 

JOBCARD 

ACCOUNT and RESOURC cards as required. 

REQUEST, TAPE99,VSN=XXX. REGEN error log. 

REWIND ,TAPE2. 

File cards as required. Maximum character length 

equals 5180. 
SORTMRG. 
RE QUEST, TAPE 1,VSN=YYY. Master data base. 

REGEN. 

7/8/9 

SORT 

BYTESIZE.60 

FILE , INPUT=TAPE99 ( CU) , 0UTPUT=TAPE2 ( R) 

FIELD, RECORD( 1,1) ,BLOCK( 2,1) 

KEY,RECORD(A,INTBCD),BLOCK(A,INTBCD) 

OPTIONS, RETAIN 

END 

7/8/9 

J0B4 

ISOLATE 01 02 

6/7/8/9 

Example 5: This job executes an isolate mode against an error log from a previous REGEN 
job. Sort/Merge is not in the system. The error log is on tape 99, and the 
master data base is on tape 1. 

JOBCARD 

ACCOUNT and RESOURC cards as required. 

REQUEST, TAPE 99, VSN=XX. REGEN error log. 

RE QUEST, TAPE 1,VSN=YY. REGEN master data base. 

REGEN. 

7/8/9 

JOB 5 

ISOLATE 01 99 

6/7/8/9 
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MESSAGES 

Two types of messages are Issued by REGEN, dayfile messages and output file messages. 

Dayfile messages provide the user with an identification of the current operation in 

progress. Output file messages provide a crosscheck of the dayfile messages, and all are 
preceded by the date and time of day. 



Dayfile Messages 

GENERATE TAPE XX 

A master data base is being generated on tape xx. 
COPY TAPE XX TO YY 

The data on tape xx is being copied on tape yy. 
REGENERATE TAPE XX 

The master data base on tape xx is being regenerated and revalidated. 
RETURN TAPE XX 

A close/unload operation is being performed on tape xx. 
RUNPASS XXXXXXX 

A pass of FST/ALX designated by xxxxxxx is being run. 
RUNNING ISOLATE MODE 

Program REGEN is currently being run in the isolate mode. 

Output File Messages 

START nnnnnn NUMBER OF RECORDS 
SELECTED = YYYY 

The job named nnnnnn has been started and the number of records selected is yyyy. 

START GENERATION OF TAPE XX 

The generation of a master data base on tape xx has begun. 

WALL CLOCK GENERATE TIME = HH.MM.SS 
(YYYY.YY CPU SECONDS USED) 

The total time taken to run the generate mode is given in hours , minutes , and 
seconds. The total CPU time in seconds is also given. 
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START COPY OF TAPE XX TO TAPE YY 

Copying the data from tape xx to tape yy has begun. 

WALL CLOCK COPY TIME = HH.MM.SS 
(YYYY.YY CPU SECONDS USED) 

The total time taken to run the copy mode is given in hours, minutes, and seconds. 
The total CPU time in seconds is also given. 

START REGENERATION OF TAPE XX 

The regeneration of the master data base on tape xx has begun. 

WALL CLOCK REGENERATE TIME = HH.MM.SS 
(YYYY.YY CPU SECONDS USED) 

The total time taken to run the regenerate mode is given in hours, minutes, and 
seconds. The total CPU time in seconds is also given. 

RETURNING TAPE XX 

The COMPASS subroutine UNLOAD has been called and is performing a close/unload 
operation on tape xx. 

WALL CLOCK RETURN TIME = HH.MM.SS 
(YYYY.YY CPU SECONDS USED 

The total time taken to run the return mode is given in hours, minutes, and 
seconds. The total CPU time in seconds is also given. 

START ISOLATE MODE 

The processing of data from the error log generated on tape 99 has begun. 

WALL CLOCK ISOLATE TIME = HH.MM.SS 
YY.YY CPU SECONDS USED) 

The total time taken to run the isolate mode is given in hours, minutes, and 
seconds. The total CPU time in seconds is also given. 

***END OF RUN*** 

This message signifies the end of the current run of program REGEN. The asterisks 
have no significance. 
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TOTAL WALL CLOCK RUN TIME = HH.MM.SS 
(YYYYYY.YY CPU SECONDS USED 

The total time taken for a complete run of REGEN is given in hours, minutes, and 
seconds. The total CPU time in seconds is also given. 

***TOTAL BITS FOR RUN = XXXXXXXXXXXX 

This is a count of the total number of bits, ones, and zeros generated and used by 
all modes during the previous run of REGEN. 

TOTAL ERRORS SAVED ON TAPE99=XXXXX 

The total number of errors entered into the error log is generated on tape 99. 

The following output file messages are generated during the isolate mode of a REGEN 
run. 

ANALYZING ERROR ON RECORD A BLOCK B 
TAPE C DUE TO D ERROR 

(BFRFWA=EEEEE) DATE=F TIME=G 

WORD EXPECTED ACTUAL DIFFERENCE 

(Words that failed to compare) 

A record containing errors and entered into the error log on tape 99 is being 
compared to a corresponding record in the master data base. 

A Record number of 1 through 3750, decimal. 

B Block number of 1 through 8. 

C Tape number of 1 through 32. 

D Error type (parity, length, position, checksum). 

E First word address of the buffer that failed. 

F Date error occurred. 

G Time error occurred. 

WORD Word number of 000 through 776 octal in the record that failed to 
compare with the master data base. To find the absolute memory 
address of a failure, add WORD+E+RA. 

EXPECTED Data from the master data base. 

ACTUAL Data from the error log. 

DIFFERENCE Logical difference between expected and actual. 
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RECORD XXXX HAD YYYY NON-COMPARE WORDS 

XXXX 1 through 3750 decimal. 

YYYY through 511 decimal. 

NORMAL TERMINATION OF ISOLATE DUE TO EOF ON 
ERROR-LOG 

An end-of-file mark was detected on tape 99 (the error log) and the isolate mode was 
terminated. 



ERROR CONDITIONS 

If FST detects a failure, as with ALX it can generate a mode 1, mode 2, or mode 4 error. 
Since FST must exit to address 377776 on a mode 1 error only, a control card must be in the 
job deck that selects mode 1. Exit and dump control cards should be used after the call to 
REGEN to provide a memory dump if FST or ALX exits on error detection. 

If ALX detects an error, the same procedure as in FST is followed except that ALX jumps to 
address 377777. 

A checksum error can occur on data read from tape x while running in the regenerate mode. 
Subroutine PVC reports the error and has the ability to isolate a single-bit failure to the 
word and bit that failed. Multiple-bit failures are detected but cannot be isolated closer 
than the 63-word block in which the failures occurred and are dumped for analysis. 

The following information is printed when an error occurs. 

File name. 

Buffer in use. 

Try/ retry condition. 

Record number . 

Block number. 

Address containing the bit that failed. 

X, Y, and Z checksum vectors generated. 

60 words of data in the block. 

Three-word checksums from tape for this block. 

Position data word for this block. 
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The format of address and bit data in 6 is: 

xxxxxxxxyyzzzzzzzzzz 

x...x Address containing the failing bit. If the failure is a multiple-bit 
failure, x...x is the fwa of the block containing the failures. 

yy Bit that failed. If yy is equal to 00, a multiple-bit failure occurred. 

z...z Equal to if the failure is a single-bit failure. It is equal to -0 if the 
failure is a multiple-bit failure. 

I/O errors are reported and retries are executed on read length and read parity errors. The 
following errors are fatal and the job is aborted. 

Write parity error on buffer out. 

EOF status on buffer out. 

EOF status on buffer in. 

Uncorrectable parity error on buffer in. 

Uncorrectable length error on buffer in. 

Position data errors can occur on data read from tape x. The following data is reported to 
the output file. 

File name. 

Buffer in use. 

Try/retry condition. 

Record number. 

Block number. 

Expected and actual data. 



ERROR MESSAGES 

All error messages written to the output file are preceded by the date and time. The 
messages are self-explanatory. 

Table 4-2 lists each error situation, the type of message issued, the contents of each 
message, and the action taken by REGEN after the message is posted. The numbers shown in 
columns 2, 3> and 4 are translated in table 4-3. 



4-28 60455980 G 



Table 4-2. Error Messages (Sheet 1 of 2) 



Problem 


D File 
Message 


0/P 
Message 


Error 
Log 


Action 


Read parity error 


1 


2 


8 


Backspace/reread 
once. 


Read parity error 
recovery 




2 




Continue. 


Uncorrectable read 
parity error 




2 




Abort job. 


Read length error 


1 


2 




Backspace/reread 
once. 


Read length recovery 




3 




Continue. 


Uncorrectable read 
length error 




3 




Abort job. 


EOF on buffer in 




2 




Abort job. 


Write parity error 




2 




Abort job. 


EOF on write 




2 




Abort job. 


Position data error 


1 


4 


8 


Up to six retries. 


Position data 
recovery 




4 




Continue (may re- 
check positions). 


Uncorrectable position 
error 




4 




Abort job. 


Data checksum error 


1 


5 


8 


Up to six retries. 


Data checksum recovery 




5 




Continue (may 
recheck positions 
and all 
checksums) . 


Uncorrectable data 
checksum error 




5 




Abort job. 


FST/ALX checksum error 




6 




Retry once; rerun 
FST/ALX once. 


FST/ALX checksum 
recovery 




6 




Continue. 
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Table 4-2. Error Messages (Sheet 2 of 2) 





D File 


0/P 


Error 






Problem 


Message 


Message 


Log 


Action 




Uncorrectable FST/ALX 




6 




Abort job. 




checksum error 












FST failure 








Mode 1 at 377776. 




ALX failure 








Mode 1 at 377777. 




Illegal runpass number 




7 




Abort runpass. 





Table 4-3. Key to Error Messages 



Message Number 


Message Contents 


1 


Time, retry count. 


2 


Date, time, record number, file name. 


3 


Date, time, record number, file name, 




length 1, length 2. 


4 


Date, time, file name, buffer, try condition, 




record number, block number, expected data, 




actual data. 


5 


Date, time, file name, buffer, try condition, 




record number, block number, address data, XYZ 




vectors, 60 words of data, expected three-word 




checksum, position data (blocks 1 through 7 




only) . 


6 


Date, time, pass count, address data, XYZ 




vectors, 60 words of data, expected checksum. 


7 


Date, time, pass count. 


8 


Record number, block number, file name, failure 




code, date, time, FWA of buffer in use, 511 




words of data. 



4-30 



60455980 G 



ERROR LOG 

In addition to the error messages and data printed via the output file, program REGEN writes 
a record to tape 99 on any of the following errors. 

Read parity error (if REGEN obtains control from the system). 

Read length error. 

Position data error. 

Checksum error on input data. 

The information recorded on tape 99 for each error consists of: 

Record number that failed (1 through 3750 decimal). 

Block number (1 through 8 if isolated, if not). 

File number (1 through 32 representing tapes 1 through 32). 

Error code ( 1 is parity, 2 is length, 3 is position, 4 is checksum). 

Date of failure. 

Time of failure. 
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MICROCODE VERIFICATION PROCESS 



The verification of microcode is a process that compares a suspected bad image of control 
store to a known good image. This is achieved by comparing the control store dump record on 
an Express Deadstart Dump (EDD) tape to the binary microde load module [contained on the 
CYBER Initialization Package (CIP) tape], used during system installation. 

When an undefined system problem occurs, a system EDD is normally performed by the 
operator. A. dump of control store (microcode memory) is contained on the EDD tape. Program 
MCDUMP reads the control store dump from the EDD tape and converts it to listable (readable) 
hexadecimal. MCDUMP is then used to convert the microcode load module from binary to 
hexadecimal. Both list files are then used as input to program MCCOMP. Xf differences are 
detected, the good and bad control store addresses and data are written to the output file. 

Another source of a good control store image would be an EDD tape created shortly after 
system initialization. 

CML installation automatically installs MCCOMP and MCDUMP. 



MCDUMP UTILITY 

The program call format is: 

MCDUMP(pl,p2,p3) 

Where pi, p2, or p3 can be any of the following in any order: 

I=lfnl From one to seven alphanumeric characters (first character must be an 
alpha) naming the local file to be dumped (default is TAPEl). 

Input data can be from: 

1. CTI/HIVS microcode record. 

2. EDD tape file: 

MCDUMP determines which one it is. 

L=lfn2 From one to seven alphanumeric characters (first character must be an 

alpha) naming the local file to which the output is written (default is 
OUTPUT). If lfn2 is not a local file, MCDUMP creates it. It does not 
rewind lfn2 either before or after the dump. 

NR. Do not rewind lfnl before the dump (default is to rewind lfnl). 

The MCDUMP utility formats and lists CYBER 170/180 Models 810, 815, 825, 830, 835, 845, and 
855 microcode from an input file. The input file can exist in one of two formats. 
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AACDUMP FORMATS 

1. The CIP tape contains the microcode. The following examples generate hardcopy listings 
of the microcode contained on the CIP tape. 

EXAMPLE: NOS CIP microcode dump 

REQUEST(CIP,NT,PE,F=SI,PO=R,LB=KU,VSN=CIP) 

COPYBR, CIP, DISCARD, xx. (xx = number of decimal records to skip - refer to 

microfiche of CIP tape for xx record numbers) 
COPYBR, CIP, MCODE. 
ATTACH, MCDUMP. 
MCDUMP( I=MCODE , L=OUT) 
ROUTE(OUT,DC=PR) 

EXAMPLE: NOS/BE CIP microcode dump 

REQUEST(CIP,NT,PE,VSN=CIP) 

COPYBR, CIP, DISCARD, xx. (xx = number of decimal records to skip - refer to 

microfiche of CIP tape for xx record numbers) 
COPYBR, CIP, MCCODE. 
ATTACH , MCDUMP , I D=CDCCE . 
MCDUMP ( I=MCCODE ,L=OUT) 
ROUTE ( OUT, DC=PR) 

2. Express Deadstart Dump (EDD) format. 

When the microcode you want to dump is on an EDD file, it is not necessary to extract 
the control store dump from the rest of the data. MCDUMP does this for you. The file 
is searched and the control store data (PCSx) is formatted and dumped automatically. 

EXAMPLE: NOS EDD microcode dump 

REQUEST(EDDTAPE,NT,PE,F=S,PO=R,LB=KL,VSN=xxxxxx) (where xxxxxx = tape label vsn)* 

ATTACH, MCDUMP. 

MCDUMP( I=EDDTAPE,L=OUT) 

ROUTE(OUT,DC=PR) 

EXAMPLE: NOS/BE EDD microcode dump 

REQUEST(EDDTAPE,NT,PE,S,E,VSN=xxxxxx) (where xxxxxx = tape label vsn)* 
ATTACH, MCDUMP , IDS=CDCCE . 
MCDUMP( I=EDDTAPE,L=OUT) 
ROUTE(OUT,DC=PR) 



T EDD created labeled tapes at CIP L004. 
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MCCOMP UTILITY 

The MCCOMP utility provides one specific function. It compares two list files that were 
previously generated by program MCDUMP. MCDUMP is run twice; once to convert a known good 
microcode file to hexadecimal, and a second time to convert a suspected microcode file to 
hexadecimal. These two output files are then compared by MCCOMP and all miscompares are 
written to a list file. 

The program call format is: 

MCCOMP, pi, p2,p3,p4. 

Where pi, p2, p3, or p4 can be any of the following in any order: 

Il=lfnl From one to seven alphanumeric characters (first character must be 
an alpha) naming either one of the list files created by MCDUMP 
(default is TAPE1). 

I2=lfn2 From one to seven alphanumeric characters (first character must be 
an alpha) naming the other list file created by MCDUMP (default is 
TAPE2). 

L=LFN3 From one to seven alphanumeric characters (first character must be 
an alpha) naming the local file to which the output is written 
(default is OUTPUT). This file shows differences between LFN1 and 
LFN2. If LFN3 is not a local file, MCCOMP creates it. The file is 
not rewound before or after the compare. 

NR Do not rewind files LFN1 and LFN2 before compare (default is to 
rewind both LFN1 and LFN2). 



MCCOMP EXAMPLES 

A typical sequence for NOS is: 

REQUEST , TAPE , NT , PE , PO=R , F=S , LB=KL , VSN=xxxxxx . 

ATTACH, MCDUMP. 

MCDUMP , I=TAPE , L=GOODMC . 

RETURN, TAPE. 

REQUEST, TAPE, NT, PE,PO=R,F=S,LB=KU,VSN=BAD. 

MCDUMP , I=TAPE , L=BADMC . 

ATTACH, MCCOMP. 

MCCOMP , I1=G00DMC , I2=BADMC ,L=OUT . 

ROUTE, OUT, DC=LP. 

A typical sequence for NOS/BE is: 

REQUEST, TAPE,NT,PE,S,E,VSN=xxxxxx. 

ATTACH .MCDUMP , ID=CDCCE . 

MCDUMP , I=TAPE , L=GOODMC . 

RETURN, TAPE. 

REQUEST, TAPE, NT, PE,S,VSN=BAD. 

MCDUMP , I=TAPE , L=BADMC . 

ATTACH , MCCOMP , ID=CDCCE . 

MCCOMP , I1=G00DMC , I2=BADMC ,L=OUT . 

ROUTE, OUT, DC=LP. 



(where xxxxxx = tape label vsn)t 
Assign good EDD tape. 
Attach MCDUMP program. 
Create good MC list file. 

Assign problem EDD tape. 
Create suspect MC list file. 
Attach MCCOMP program. 
Compare/Write to out . 
list miscompares. 



(where xxxxxx = tape label vsn)t 
Assign good EDD tape. 
Attach MCDUMP program. 
Create good MC list file. 

Assign problem EDD tape. 
Create suspect MC list file. 
Attach MCCOMP program. 
Compare/Write to out . 
List miscompare. 



tEDD created labeled tapes at CIP L004. 
60455980 T 
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VERIFICATION PROCESS 

A typical verification process follows: 

1. Convert good control store binary. 

NOS CIP tape 

REQUEST, CIP, NT, PE,F=SI,PO=R,VSN=CIP,LB=KU. 

COPYBR, CIP, DISCARD, xx. (where xx is number of decimal records to skip) 

COPYBR, CIP, GOOD. 

RETURN, CIP. 

ATTACH, MCDUMP. 

MCUUMP , I=GOOD , L=GOODMC . 

NOS/BE CIP tape 

REQUEST, CIP, NT, PE,VSN=CIP. 

COPYBR, CIP, DISCARD, xx. (where xx is number of decimal records to skip) 

COPYBR,CIP,GOOD. 

RETURN, CIP. 

ATTACH, MCDUMP, ID=CDCCE. 

MCDUMP, I=GOOD,L=GOODMC. 

2. Convert suspected bad control store dump. 
NOS EDD dump 

REQUEST, EDDBAD,NT,PE,F=S,PO=R,LB=KL,VSN=xxxxxx. (where xxxxxx = tape label vsn)' 

ATTACH, MCDUMP. 

MCDUMP , I=EDDBAD , L=BADMC . 

NOS/BE EDD dump 

REQUEST, EDDBAD, NT, PE,S,E,VSN=xxxxxx. (where xxxxxx = tape label vsn)' 
ATTACH .MCDUMP , ID=CDCCE . 
MCDUMP , I=EDDBAD , L=BADMC . 

3. Compare the two converted files and list all the differences. 

NOS compare list 

ATTACH, MCCOMP. 

MCCOMP , I 1=G00DMC , I 2=BADMC , L=OUT . 

ROUTE, OUT, DC=PR. 

NOS/BE compare list 

ATTACH, MCCOMP. 

MCCOMP , I 1=G00DMC , I2=BADMC , L=OUT. 

ROUTE, OUT, DC=PR. 



NOTE 



If there are no miscompares, MCCOMP does not 
generate an output file. The message, 
COMPARE GOOD, is written to the dayfile. 



T EDD created labeled tapes at CIP LOOA. 
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SKEDULR 



SKEDULR is an application program that assists in the implementation of concurrent 
maintenance, remote technical assistance, and the on-call maintenance strategy for CYBER 
systems. 

SKEDULR automatically submits NOS and NOS/BE jobs to the system input queue. This permits 
maintenance jobs (MALET , HPA, REGEN, TIO, CEAIDS) to be initiated without the need for 
manual intervention. SKEDULR allows maintenance jobs to be executed at times convenient to 
the customer, and the customer engineer need not be present. This concept is helpful at 
installations maintained from a service center in an on-call maintenance environment. 
Proper use of SKEDULR also supports the remote technical assistance center concept. 

Three elements exist in the scheduling function as follows: 

• The scheduler (SKEDULR). 

• The jobs to be executed. 

• The schedule (list of jobs to be scheduled). 

Normally, all three elements reside on system permanent files. SKEDULR can be executed as a 
job from a user file and does not have to be installed into the customer's system or reside 
on the deadstart tape. 

The next task is to generate the jobs to be executed. The jobs vary with each installation 
but typically include daily runs of HPA and REGEN, weekly runs of diagnostics on each 
peripheral, weekly runs of HPA for tape media reports, CAMS runs, and so on. Any job 
currently executed manually is a candidate for this list. These jobs must be saved as 
permanent files for later execution (indirect access permanent files for NOS). 

Once the jobs are created, the schedule of when the jobs are to be run must be generated. 
This is accomplished by creating a file using the operating system EDIT or EDITOR feature, 
or keypunching the file and saving it as a permanent file (indirect access file for NOS). A 
typical entry in this file is as follows: 

RUN D44020A MONDAY AT 2300 

This entry directs SKEDULR to submit file D44020A to the system input queue every Monday 
night at 2300 hours (11 p.m.). The syntax for the RUN directives provides the flexibility 
to submit any number of jobs at a variety of intervals, from several times a day to once a 
year. 



INSTALLING SKEDULR 

(Refer to section 1, under CML Installation, for installation procedures.) 
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CREATING JOBS TO EXECUTE 

EDIT or EDITOR can be used to create the jobs to be executed, or the jobs can be 
keypunched. In either case, the jobs must be saved as permanent files for later execution 
(indirect access files under NOS) . The content of each job depends upon the task that must 
be accomplished. There are two basic formats for jobs that are to be submitted. 

• If the first line of the file contains /JOB in columns one through four, SKEDULR 
creates a new file to be submitted. The /JOB statement is eliminated and any lines 
with /EOR or /EOF in columns one through four are replaced by the end-of-record or 
end-of-file, respectively. This allows the user to create a multirecord file with 
editors that are not capable of identifying 7/8/9 cards (EOR) or 6/7/8/9 cards 
(EOF). A typical example is as follows (NOS format shown): 

/JOB 
I D44O2OA,P4,T2O0. 

User/Account cards as required. 

ATTACH, RFILE=D44. 

Request engineering mode and EST20 access. 

MALET. 
■ REPLACE, OUTPUT=O44020A. 

EXIT. 
I REPLACE, OUTPUT=O44020A. 

/EOR 

ASSIGN, EST=20 ,CH=31 ,AL=3 

CLRSW SE 

RUN D44(01 ,02 ,03 ,04 ,05 ,06 ,07 ,08 ,09 ,10 ,11 ,12 ,13,14 ,15,16) 

ASSIGN, EST=20,CH=30,AL=3 

RUN D44(01 ,02 ,03 ,04 ,05 ,06 ,07 ,08 ,09 ,10 ,11 ,12 ,13 ,14 ,15 ,16) 

/EOF 

• If the first line of the file does not contain /JOB, the file is submitted without 
any changes. A typical example of this format is as follows: 

| D44O2OA,P4,T2O0. 

User/Account cards as required. 

ATTACH, RFILE=D44. 

Request engineering mode and EST20 access. 

MALET. 
| REPLACE, OUTPUT=044020A. 

EXIT. 

REPLACE ,0UTPUT=044020A. 

7/8/9 (EOR) 

ASSIGN, EST=20 ,CH=31 ,AL=3 

CLRSW SE 

RUN D44(01 ,02 ,03 ,04 ,05 ,06 ,07 ,08 ,09 ,10,11 ,12 ,13 ,14 ,15 ,16) 

ASSIGN, EST=20,CH= 30, AL=3 

RUN D44(01,02,03,04,05,06,07,08,09,10,11,12,13,14,15,16) 

6/7/8/9 (EOF) 

In the examples, the diagnostic output is saved as a permanent file in addition to being 
printed at the local site ( REPLACE, 0UTPUTO44020 A) . This technique provides a hardcopy for 
on-site customer engineers and the permanent file copy can be accessed from a remote service 
center or technical assistance center. 



I 
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CREATING THE JOB SCHEDULE 

Once the job decks are created, a schedule must be generated on permanent file JOBS (JOBSxx 
if NOS multimainframe) . This file must be an indirect access file for NOS. 

Jobs to be executed are defined with RUN directives that are in 80-column format, starting 
in column one as follows: 

RUN lfn when AT time, time, time, .. . 

lfn Permanent file name of the file to be submitted (one to seven characters). 
This must be an indirect access file for NOS. 

when Day the job is to be submitted. The following keywords are allowed: 



DAILY 

WEEKDAYS 

WEEKENDS 

SUNDAY through SATURDAY 

MONTHLY (x) 

MONTYLY (y z) 



MONTHLY (LAST DAY) 

JANUARY through DECEMBER (x) 



Seven days a week 

Monday through Friday (five days) 

Saturday and Sunday 

On one specific day 

Monthly on day x (1 through 31) 

Monthly on day y z 

y FIRST through FIFTH 

z SUNDAY through SATURDAY 

(for example, MONTHLY (SECOND MONDAY)) 

Monthly on last day 

Specific month, day x (1 through 31) 



JANUARY through DECEMBER (y z) Specific month, day y z 

y FIRST through FIFTH 
z SUNDAY through SATURDAY 
{for example, JULY (FOURTH FRIDAY)} 

time Time of day the job is to be submitted (0000 through 2359). This is decimal 
military time defined in four digits (leading zeros required) with no 
separators. If the job is to be submitted more than once per day, multiple 
times can be specified. 

Single blanks and/or commas can be used as delimiters between each word or time entry; 
however, two blanks terminate the RUN directive. Remaining columns, if any, may be used for 
documentation. 

Examples : 

RUN HPASUM DAILY AT 0830 

RUN REGEN01 DAILY AT 0800,1000,1200,1400,1600,1800,2000 

RUN REGEN02 WEEKDAYS AT 2300 

RUN REGEN03 WEEKENDS AT 1900 

RUN D44020A MONDAY AT 0400 *RUN D44 ON EST 20 

RUN HPAMON MONTHLY (15) AT 1500 

RUN FTP015A MONTHLY (FIRST MONDAY) AT 1200 

RUN HPATERM MONTHLY (LAST DAY) AT 2300 

RUN CAMSRUN JULY (15) AT 0800 

RUN CAMS JULY (FIRST WEDNESDAY) AT 0900 
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EXECUTING SKEDULR — NOS 

To start the scheduling function under the NOS operating system, the following job must be 
executed: 

SKED,P4,T0. 

User and charge cards as required. 

GET, SKEDULR. 

SKEDULR. 

EXIT. 

DISPLAY, DATE. 

REQUEST, HELP. SKEDULR ABORTED. 

6/7/8/9 (EOF) 

SKEDULR puts a date and time stamp on the time file (TFILE), rolls out for 30 minutes, and 
determines if the time stamp has been changed on TFILE. If it has, another copy of SKEDULR 
is running and this copy terminates. If not, a fresh copy of the JOBS file is obtained and 
processed. Jobs that need to be scheduled are submitted to the input queue and SKEDULR 
rolls out for 15 minutes or until it is time to schedule the next job, whichever is less. 

The process of obtaining a fresh copy of the JOBS file at least every 15 minutes allows the 
scnedule to be changed if it is necessary (by modifying JOBS or JOBSxx) and the new schedule 
is put into effect within 15 minutes of the changes. 

Due to the protection feature (ensuring two or more copies of SKEDULR are never executing at 
the same time), the scheduling function job can be executed after every system deadstart, if 
desired. It must be executed again if SKEDULR aborts, after the cause of the abort is 
corrected. A message is issued to the operator when this occurs. SKEDULR aborts if it 
submits a job to the input queue that contains an invalid user card. 

When SKEDULR submits jobs to the input queue, the job being submitted is given an origin ID 
that is the same as SKEDULR. If SKEDULR was initiated using the scheduling function job, 
all jobs submitted would have an origin of batch, with no special privileges. However, if 
SKEDULR is initiated from the system console, using DIS, it would have system origin 
privileges. This is a very powerful capability that must not be misused, but it can be 
useful since this mode allows the running of NORM/GETLOG/HPA jobs without the system being 
in debug mode. 



EXECUTING SKEDULR — NOS/BE 

SKEDULR is executed as normal job under the control of the automatic program recall (APR) 
feature of NOS/BE so that it is executed every 15 minutes. This ensures that jobs are 
scheduled within 15 minutes of the requested time and a new or modified JOBS file can be put 
into effect within 15 minutes of being created. The following job should be executed: 

SKED.TO. (accounting if necessary) 

ACCOUNT, (if necessary). 

APR( 1,001702) 

ATTACH, JOBS, ID=(user ID). 

ATTACH, SKEDULR, ID= (user ID). 

SKEDULR. 

EXIT. 

REQUEST .HELP. SKEDULR ABORTED. 

6/7/8/9 (EOF) 
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In the APR call, the parameters (1,001702) request APR to put this job into the APR table 
for recall in 15 minutes. The last two digits of the request indicate the job number APR 
assigns to this job (02). 

SKEDULR uses the time file (TFILE) to determine when it was last executed. This allows it 
to schedule jobs that fall into the current time frame and when SKEDULR was last run. The 
entire JOBS file is processed, SKEDULR exits and is placed into the APR table, and executes 
again 15 minutes later. 
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EXECUTIVE RUNNING AND ERROR MESSAGES 



The following are the running and error messages issued by MALET. 

CIO PP UNAVAILABLE TO MALET. 

NOS was unable to load MLD into a concurrent PP because one was not available. 
Ensure CIO PP available and rerun. 

CVT ERROR VALUE. 

Error in the process of converting value to binary. 

DAYFILE LIMIT REACHED DAYFILE LOG TURNED OFF 

One-hundred (decimal) dayf ile messages have been logged. No more are allowed until 
the dayfile log switch is turned on. 

DROPPED BY USER. 

DROP directive encountered. 
END OF TEST SERIES. 

Test series being run has encountered an END statement. 

EOF/EOI INPUT END MALET. 

End-of-f ile or end-of-inf ormation encountered on input and MALET K/L display is not 
turned on. 

ERROR EF = xx P = yyyy. 

Error occurred where xx = error flag and yyyy = P address. The error flag values 
are as follows: 



NOS Version it 

EF = 01 Arithmetic error. 

= 02 CPU encountered program stop. 

= 03 PP abort. 

= 04 CPU abort. 

= 05 PP call error. 

= 06 Time limit. 

= 07 File limit. 

= 10B Track limit. 

= 11B SRU limit. 

= 12B Forced error. 

= 13B Operator dropped job. 

= 14B Special error flag or job rerun. 

= 15B Operator killed job. 

= 16B Subsystem abort. 



tFor further information about error messages, refer to NOS Version 1 Reference Manual, 
Volume 2. 
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NOS Version it continued 

= 17B ECS parity error. 

= 20B CPU or CM parity error. 

= 21B System abort. 

= 22B Override of error condition. 

NOS Version 2, NOS/BEt t 

PP PROGRAM REQUESTED ABORT 

PP CALL ERROR 

OPERATOR DROP 

OPERATOR KILL 

OPERATOR RERUN 

ECS PARITY ERROR 

AUTO-RECALL ERROR 

HUNG IN AUTO-RECALL 

PP PROGRAM NOT IN LIBRARY 

TERMINAL INTERRUPT 

FORMAT WAS OUT OF RANGE. 

Format statement could not be found. Check, module source for error. 

HALT - STOPPED ON ERROR. 

Module executed a HALT command. To resume execution a GO directive must be entered 
through K/L display, if running on console; or input, if running with a terminal. 

ILLEGAL SEPARATOR RE-ENTER. 

Separator was not recognized by MALET. Reenter -with legal separator. 

ILLEGAL WHEN MODULE NOT RUNNING. 

Directive is illegal when module is not running. For example, STOP when module is 
not running. 

ILLEGAL WHEN MODULE RUNNING. 

Directive is illegal when module is running. 



Please enter input to MALET on terminal. 
K/L DISPLAY NOT ON - DROP FORCED. 

K/L display flag not set. Drop is forced when assign with validation denied given. 

LANGUAGE CHANGE - MODULE TERMINATED. 

In response to a CALL directive, a module was called that is not written in the same 
language as the module that performed the call. 



tFor further information about error messages, refer to NOS Version 1 Reference Manual, 
Volume 2. 
ttFor further information about error messages, refer to NOS Version 2 Reference Set, Volume 
2, Guide to System Usage, or NOS/BE Version 1 Reference Manual. 
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LINE LIMIT — GO/DROP. 

Line limit reached, user must give GO or DROP to resume with default line limit 
restored. 

LINE VALUE OUT OF RANGE. 

Value too large. Reenter with a value that is in range. 
MALET ABORTED. 

MALET was aborted due to some unrecoverable error. 
MODULE CHECKSUM ERR. 

Checksum did not compare with checksum within binary. 
MODULE DOES NOT SUPPORT DEVICE CODE. 

Device codes stored in module do not include current one assigned. 
MODULE FUNCTION OUT OF RANGE. 

Internal error. Function being sent by PP is not recognized by the MALET executive. 

MODULE INITILIZE ERROR MALET DROPPED. 
MODULE INITILIZE ERROR — SEE DAYFILE. 

MALET PP driver program MLD has found an error in the module binary. MALET is 
dropped if the K/L display is off. 

MODULE LOCKED USE NEW NAME. 

Module lock parameter was used when binary was made. 
MODULE NAME MUST BE 5 CHARACTERS. 

Module name must be five characters . 
MODULE NOT CHECKPOINTED. 

Module binary was not saved for restart. Must use RUN directive to resume execution. 
MODULE NOT FOUND = name. 

Module name not found on random file. 
MODULE NUMBERS MUST BE 2 DIGITS. 

Module numbers must be two digits on RUN directive. 

MODULE WILL NOT RUN WITH ACCESS LEVEL .LT. 10 8 . 

Module is low level. Access level for low level must be greater than or equal to 
10 8 . 

MODULE WRITTEN = name. 

Module was compiled correctly and binary placed on random file. 
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MODULES DUMPED. 

Dump directive has written modules on binary file. 
MULTIPLE CALLS - MODULE TERMINATED. 

A CALL command was executed while a previous CALL was still active. 
NO DEVICE ASSIGNED. 

Device is not assigned. Enter ASSIGN directive before trying to run module. 
NO NAME FOR MODULE. 

Module name on directive is missing. 
GO/DROP. EQOOO-VERIFY DOWN ON ALL MAINFRAMES. 

Operator must ensure independent shared device is downed on all mainframes. 
GO/DROP. EQOOO-VERIFY UNLOAD ON ALL MAINFRAMES. 

Operator ensures independent shared device unloaded on all mainframes. 
GO/DROP ESTOOO COO U00 AL0000. 

Permission is granted to use the device. However, operator must verify that the 
device is not being shared by another system. If the EST ordinal is not defined, the 
device was not found in the system. 

GO/DROP HALT STOPPED ON ERROR. 

Module executed a HALT command and job is running in batch mode. To resume 
execution, operator must enter a CONTROL POINT GO command where N is the control 
point number. 

GO/DROP INDETERMINANT SITUATION. 

If remote NAD rejected (403 16 ) or unable to initialize (107 16 ) for the 
state/clarifier, enter N.GO if remote host is not using NAD. 

GO/DROP. I/O DRAWER(S) OPEN OR IN OCCUPIED. 

One or more of the I/O drawer(s) is open or occupied. Correct and have operator 
enter N.GO.(CR), where N is the control point number. 

GO /DROP. UNABLE TO CLR CARTRIDGE(S) FROM MST. 

Due to a failure, the cartridge(s) cannot be returned to their proper location 
within the matrix. Manual intervention is required to remove the cartridge (s) and 
validation is granted via an entry of N.GO.(CR) from the operator. 

GO/DROP. UNABLE TO READ LABEL. 

Label could not be read; assignment allowed if OPERATOR GO is entered. 

OPERATOR GAVE GO. 

Operator has given an X.GO response to the SEND command message which was flashing 
on the B display. 
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PARAMETER ERROR .. PARAMETER 

Parameter was in error. Reenter with correct parameter. 

PARAMETER ERROR .. KL ILLEGAL 

Selecting KL while in terminal mode is an illegal command. If this occurs on the 
MALET call, MALET is aborted and the message is logged in the dayfile. If the 
SETSW.KL directive is used the message displayed is PARAMETER ERROR .. KL ILLEGAL 
but MALET is not aborted. 

PPU OVERLAY NAME OUT OF RANGE. 

Illegal product overlay referenced by a module. 

RANDOM FILE FULL = name. 

Random file index table is full on module name. Only 200 modules are allowed on the 
random file. 

REQUEST K/L DISPLAY . . MALET. 

MALET requests the K/L display to be assigned to its control point. 

ROLLOUT MODULE NOT CHECK POINTED. 

MALET rolled out before the module was stopped. Use RUN directive to resume 
execution. 

RMS/AL GE 10 DISABLE UNITS NOT UNDER TEST ON CHCC. 

A rotating mass storage device has been assigned and validation has been granted at 
access level greater than or equal to 10. The user can protect the drives on 
channel cc by setting the drive disable switches in channel cc's controller. 

RUN DIRECTIVE INCOMPLETE NEEDS ). 

RUN directive was entered and never terminated. Enter ) to terminate RUN directive. 

SOURCE BUFFER FULL. 

Source buffer is full. No more source entries, including the one which initiated 
this message, will be accepted until an executive directive is encountered. 

SYNTAX ERROR. 

Syntax error on input directive. Reenter. 
TOO MANY MODULES ON RUN DIRECTIVE. 

RUN directive can contain only 100 module numbers. 
VALIDATION DENIED. ADDRESS OUT OF RANGE. 

Address is out of range on CVL call. Reassign the device after checking parameters. 



60455980 P A-5 



VALIDATION DENIED- AL TOO HIGH. 

Response code from CVL was 14s or access level was too high to gain validation. 
VALIDATION DENIED- AL ILLEGAL. 

Access level (AL) is illegal. Use legal value. 
VALIDATION DENIED- AL TOO LOW. 

Access level (AL) not high enough to gain validation. 
VALIDATION DENIED- CAN NOT ACCESS NETWORK. 

If user is not authorized to access network, access is denied. 
VALIDATION DENIED. CEVAL I/O SEQUENCE ERROR. 

CEVAL detected an I/O sequence error. Reassign the device after checking parameters. 
VALIDATION DENIED-CH.EQ.UN OR EST NEEDED. 

Device CH, EQ, UN, or EST ordinal must be provided as a minimum to gain validation 
to a device. 

VALIDATION DENIED- CH IN ERROR. 

Channel number is in error. Channel number provided is not legal on system as 
defined by CVL. 

VALIDATION DENIED- CRITICAL INFO MAY BE DESTROYED. 

Device contains permanent file information. 
VALIDATION DENIED- CSU ERR WHEN LOAD CE CARTRIDGE. 

CSU error occurred when loading CE cartridge. 

VALIDATION DENIED- CVL RESPONSE OUT OF RANGE. 

Response code given by CVL is not within the range of response codes expected by 
MALET. 

VALIDATION DENIED- DC NEEDED EST ABSENT. 

Device code is needed if the EST number is absent. 
VALIDATION DENIED- DEVICE IN MAINT. STATE. 0000. 

Device is in maintenance state already. 
VALIDATION DENIED- DEVICE IN TEST STATE. 0000. 

Device is in test state. 
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VALIDATION DENIED- DEVICE NOT FOUND. 

CVL could not find device in system EST. 

VALIDATION DENIED- DEVICE STATUS ERROR. 

The response to CVL when trying to select/connect path RH was not correct, local NAD 
not running, PATH status could not be obtained, remote NAD busy, and so on. 

VALIDATION DENIED. ENTRY FOUND IN EST. 

En entry was found in the EST for the device being assigned with an EST=NO 
parameter. Reassign by EST or do not use EST=N0. 

VALIDATION DENIED. ENTRY NOT IN EST. 

An entry for the device selected was not found in the EST. Use the EST=NO parameter 
on the assign statement. 

VALIDATION DENIED. FILE NOT FOUND FOR TAPE PREASSIGNMENT. 

When using MNE=MT or NT on the MALET assign directive a file was not found that 
needs to be assigned to MALET's JSN. Drop MALET and assign a file to MALET's JSN 
and then recall MALET. 

VALIDATION DENIED- ILLEGAL CE CARTRIDGE COORDINATE. 

Cartridge location was not a CE location. Refer to MSC writeup for user(s) area. 
VALIDATION DENIED- IN USE BY SYSTEM. 

Device is on or in use by system. 

VALIDATION DENIED. INCORRECT CEVAL PARAMETER COMBINATION. 

Parameter combination sent to CEVAL by MALET is incorrect. Reassign the device 
after checking parameters. 

VALIDATION DENIED. INCORRECT CEVAL REQUEST PARAMETER(S). 

Parameters sent to CEVAL by MALET are incorrect. Reassign the device after checking 
parameters. 

VALIDATION DENIED- ISD ERR WHEN LOADING CE CARTRIDGE. 

IDS had an error when loading CE cartridge. 
VALIDATION DENIED. LABELED TAPE WAS PREASSIGNED. 

Cannot have a labeled tape for tape p reassignment. Reassign an unlabeled tape. 
VALIDATION DENIED- LOCAL DC BAD. 

CVL passed a response code of 12g. To be implemented at a future date. 
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VALIDATION DENIED. MNE /DEVICE CODE INCOMPATIBLE. 

Device code selected is not the same as the one defined by the mnemonic in the EST. 
Reassign by EST and do not use device code. Else, the mnemonic in the EST must be 
changed to the correct type. 

VALIDATION DENIED- MSC MOUNTED NOT CE CARTRIDGE. 

MSC cartridge mounted, not a CE cartridge. 
VALIDATION DENIED- MSS SUBSYSTEM NOT ACTIVE. 

MSS executive was not active. 
VALIDATION DENIED- NAD CONNECTED TO HOST. 

Remote NAD being used by its host. CVL was able to connect path RH. 

VALIDATION DENIED- NO TCU ENABLE SET. 

The parameter TCU was not set properly on the ASSIGN directive. Reenter ASSIGN 
directive with correct TCU enables. 

VALIDATION DENIED- PICKER CONTAINS CARTRIDGE. 

Picker contains cartridge, must be cleared before being assigned. 

VALIDATION DENIED- REMOTE DC BAD. 

Device code 301s was not handled correctly by MALET. This message should never be 
posted. 

VALIDATION DENIED- SN MUST BE PROVIDED. 

Serial number must be provided for access level used. 

VALIDATION DENIED-SN IN ERROR. 

Serial number did not match disk pack serial number, or disk pack serial number not 
obtainable by system. 

VALIDATION DENIED- UNABLE TO ACCESS EQUIPMENT. 

Could not access MSS equipment. Therefore, validation is denied. 
VALIDATION DENIED- XY LOCATION EMPTY. 

xx and yy coordinate did not contain a cartridge, retry with corrected coordinates. 
VALIDATION GRANTED- ESTOOO COO U00 ALOO DCOO. 

Validation has been granted for the device. 

VALUE TOO LARGE = nnnnnnnn. 

Value was too large on parameter register entry. Value must be less than 4096 to fit 
into a 12-bit field. 
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VERSION NUMBER ERROR REASSEMBLE. 

Current version of MALET does not match version number stored in module. If the user 
wants to run module, it must be reassembled. 

MLD MESSAGES 

MLD FL ERR 

Address currently being referenced by MLD is outside of MALET's field length. 
MLD PARAM CALL ERR 

• Address used by MLD in MALET greater than 12 bits. 

• Address passed to MLD by MALET does not contain correct data. 

• Binary code passed to MLD is too large for buffer area. 
MLD VERS ERR 

• Correct data not passed to MLD for legal call. 

• Version number of MLD does not match MALET. Modification missing for MLD or 
MALET (REL2B/PL5 or CML3.X). 

• Version number of compiled module does not match MLD's version. Reassemble 
modules. 

MLD ILLEG CPU REQ 

Illegal request from MALET to MLD. Code was not a start (1) or a resume (2) request. 

MLD MOD HEAD ERR 

• Data for OB greater than buffer area for OB. 

• Line number to start module greater than 167g. 

• Address to store binary out of range of binary buffer. 
MLD ILLEG USER ACC 

• ENGR. mode not on. 

• MALET not installed on system. MLD was called by a program being run from a 
local file. 

• User does not have SYSTEM privileges (NOS). 
MLD CH IN USE 

The channel requested by MLD is down. Rerun the job after ensuring that another 
control point does not have dedicated use of the channel. 
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SBP MESSAGES 

SBP ADDRESS NOT IN PROGRAM FL 

Address being tested by SBP subroutine is not within field length. 
SBP INITIALIZATION ERROR 

• Incorrect data passed on call to SBP. 

• Error flag set at control point during initialization. 
MALET AUTO DCN PERFORMED CH=XX. 

• Channel XX being used by MLD was active and full for 5 seconds. SBP did a DCN on 
channel XX. 

• Channel XX being used by MLD was active and empty for 5 seconds. SBP did a DCN 
on channel. 

SBP MODULE VERSION ERROR 

• Correct data not passed to SBP for legal call. 

• Version number of SBP does not match MALET. Modification missing for SBP or 
MALET (REL2B/PL5 or CML3.X) 

SBP MALET/DRIVER CHANNEL MISMATCH 

Channel passed to SBP by MALET did not match channel passed by MLD. 

SBP ILLEGAL USER ACCESS 

• ENGR. mode not on. 

• Program that called SBP was not being run from systems file. 

• User does not have system privileges (NOS). 

CVL MESSAGES 

CVL CALL ERROR 

Program calling CVL did not have parameter block set up correctly. 

ILLEGAL USER ACCESS 

The user tried to perform an operation for which he or she is not validated (for 
example, attempting to run MALET from nonsystem origin). Have account update for 
system origin privileges, or run MALET from console under DIS. 
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USER VALIDATION DENIED 

MALET must be run from the console, or If the user has system origin privileges, set 
engineering mode and resubmit job. 

For NOS 2.0 and above, MODVAL parameter SAV=COLD validates the user to use on-line 
diagnostics. 
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MALET UTILITY DECK STRUCTURES 



B 



The following deck structures permit the creation of permanent files for the MALET modules 
and the extraction of documentation from these files for both the NOS and the NOS/BE 
operating systems. 



MALET MODULES - NOS 

To install the MALET diagnostic modules as permanent files, run the following job. 

MODULE S,T 1000. 

ACCOUNT /CHARGE CARDS. 

LABEL, OLDPL,VSN=CMLVSN, NT, PE,F=S1. 

SKIPF.OLDPL. 
$ UPDATE, Q,R=C. 
$ DEFINE ,RFILE=T6X. 
$ MALET, I=C0MPILE,L0=S. 
$ UNLOAD ,RFILE. 

7/8/9 
$ *C T6Xt 
$ 7/8/9 
$ 7/8/9 

6/7/8/9 



Direct access file. 
Compile modules to RFILE. 



Compile T6X. 



Repeat for each test series wanted. 











*ID=xxx 


For DEMA 


large 


sector diagnostics the 


format: ■ 


*DEFINE,xxxx 
*C0MPILE,xxx 


Diagnostic 


DEFINE 


COMPILE 


FMD 




*DEFINE,SFMD 


*COMPILE,FMD 


FHD 




*DEFINE,PFMD 


*COMPILE,FMD 


FLD 




*DEFINE ,LSFMD 


*COMPILE,FMD 


D88 




*DEFINE,SFMD 


*C0MPILE,D88 


DH8 




*DEFINE,PFMD 


*C0MPILE,D88 


DL8 




*DEFINE,LSFMD 


*c 


OMPILE D88 



is used as follows : 
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MALET MODULES DOCUMENTATION— NOS 

To acquire external and/or internal documentation from MALET diagnostic modules, run the 
following job: 

DOCIT.T500. 

ACCOUNT /CHARGE CARDS. 

LABEL , CMLVSN , VSN=CMLVSN , NT , PE , F=SI . 

SKIPF.CMLVSN.l. 

COP YBF , CMLVSN , OLDPL . 

UPDATE, Q,C=SOURCE. Get modules. 

UPDATE, Q. Get MLTDOC. 

FTN5,I=COMPILE,PL=999999. Compile MLTDOC. 

LGO, SOURCE. External to OUTPUT, 

$ REWIND, PRINT. internal to PRINT. 

$ COPYEI, PRINT, OUTPUT. Copy internal 

7/8/9 documentation to OUTPUT. 

*C T6X List test series wanted. 

7/8/9 

*C MLTDOC 

7/8/9 

6/7/8/9 

$ Eliminate these cards if internal 
documentation is not required. 



MALET MODULES— NOS/ BE 

To install the MALET diagnostic modules as permanent files, run the following job. 

MODULES, T 1000 ,MT1. 

LABEL , CMLVSN , VSN=CMLVSN , D=PE , NORING. 

SKIPF.CMLVSN.l. 

COPYBF , CMLVSN , OLDPL . 
$ UPDATE, Q. 
$ REQUEST,RFILE,*PF. 
$ MALET , I=C0MPILE , L0=LS . 
$ CATALOG, RFILE,T6X,ID=Y0UR ID. 
$ UNLOAD, RFILE. 

7/8/9 
$ *C T6XT Compile T6X. 

$ 7/8/9 
$ 7/8/9 

6/7/8/9 



$ Repeat for each test series wanted. 



t Refer to MALET Modules - NOS earlier in this section. 
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MALET MODULES DOCUMENTATION— NOS/ BE 

To acquire external and/ or internal documentation from MALET diagnostic modules, run the 
following job: 



DOCIT,T500,MT1. 

LABEL .CMLVSN ,V SN= CMLVSN ,D=PE , NORING . 

SKIPF.CMLVSN.l. 

COPYBF .CMLVSN .OLDPL. 

UPDATE ,Q,C=SOURCE. 

UPDATE, Q. 

FTN5 , I=COMPILE ,PL=999999 . 

LGO, SOURCE. 
$ REWIND .PRINT. 
$ COPYBF .PRINT, OUTPUT. 

7/8/9 

*C T6XT 

7/8/9 

*C MLTDOC 

7/8/9 

6/7/8/9 



Get modules. 
Get MLTDOC. 
Compile MLTDOC. 
External to OUTPUT, 
internal to PRINT. 



List test series wanted. 



$ Eliminate these cards if internal 
documentation is not required. 



EXAMPLES OF RUNNING JOBS 

The following jobs assume that the user has created permanent files of the 
MALET modules. 



NOTE 



To run any of the following jobs on NOS/BE, 
change the ATTACH card to: 

ATTACH , RF ILE , nnn , ID=xxx . 

nnn Name of the MALET diagnostic, 
test , or utility permanent 
file. 

xxx Your identification number. 



tRefer to MALET Modules - NOS earlier in this section. 
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Sample Jobs 

Run RMS tests at AL=3 on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.K.L. 

7/8/9 

ASSIGN, EST=nn,AL=3. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 



Test or Utility and Description (nnn) 

D44 7X54 and 7155 controllers with 
844-2X and 844-4X disk drives. 

F44 FSC disk subsystem test 

(100- and 200-megabyte disk). 

F88 FSC disk subsystem test 
(317-megabyte disk). 

FMD Fixed module drive diagnostic. 

FHD 885-4X fixed module drive (DEMA) 
diagnostic. 

FLD Fixed module drive (large sector) 
diagnostic. 



Run RMS tests at AL=4 on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET RFlLE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN , EST=nn , AL=4 , SN=xxxxxx . 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 



D88 FMD subsystem confidence test. 

DH8 7155-401/885-4X DEMA disk 
subsystem confidence test. 

DL8 7155/885 large sector disk 
subsystem confidence test. 

DTC 7155 with 844-4X drive test. 



Run RMS controller tests at AL=10 on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn, AL=10 , SN=xxxxxx. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 



FMC 7155-1, 1X(FA211-A/B) disk 
controller diagnostic. 

FHC 7155-4X(FA211-C) disk 
controller diagnostic. 

FEP FMD/ESM path test (DEMA). 



NOTE 



In the previous jobs: 

PX 



Any parameter register P0 
through P9. 



yyyy The value to be set in that 
parameter register. 

For the correct parameter settings and 
access levels, refer to the 99 module or to 
the external documentation of the selected 
diagnostic, test, or utility. 

When assigning large sector devices in the 
EST, the DC=16 parameter is also needed. 
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Sample Jobs 

Run Intelligent Peripheral Monitors/Tests at 

JOB/ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET,KL. 

7/8/9 

ASSIGN ,EST=nn,AL=3. 

P,PX=yyyy. 

R,nnn. or R,nnnxx. (xx is one 

6/7/8/9 module number.) 

Run Formatting Utilities at AIM on NOS: 

JOB/ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST =nn,AL=4,SN=xxxxxx. 

P,PX=yyyy. 

R,nnnxx. (xx is the module.) 

6/7/8/9 



Test or Utility and Description (nnn) 

AL=3 on NOS: 

FSD ISD subsystem monitor and 
utility test. AL=10 must 
be used for some modules. 

NIP Nonimpact printer test. 
Runs at AL=10. 

DTI ISD/895 subsystem data 
path integrity test. 



FMU Format utility for 885-1X, 885-4X 
(DEMA), 885 (large sector), and 
844-4X disk drives. 

FFU Format utility for federal 
standard disk subsystems. 

DFU Format utility for 834, 836, and 
895 disks. 



1 NOTE | 

Some modules may need AL=10. 



Run Buffer Controller Tests at AL=10 on NOS: 

JOB/ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

ATTACH ,MY8BC. or GET.MY8BC. 

MALET.KL, S=MY8BC. 

7/8/9 

ASSIGN, EST=nn,AL=10. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 

Run Loader /Monitors at AL=10 on NOS: 

JOB/ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

ATTACH, NDM.NDP. or GET.NDM.NDP. 

MALET.KL. 

7/8/9 

ASSIGN ,EST=nn,AL=10. 

SCRATCH=zzz. Where zzz is NDM or NDP. 

P,PX=yyyy. 

R.nnn. 

6/7/8/9 



MY8 



Buffer controller memory test. 



BUCAL code from file 3 or 4 of CML. 
(File 3 is MY8BC for MY8 and file 4 is 
BCXBC for BCX). Both files are saved 
when defining 66X or 7X54 using the 
CMLINST procedures. 



BCX 



Buffer controller command test. 



FLM Federal standard channel 
loader monitor. 

CLM CYBER Channel Coupler 
loader monitor. 
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Sample Jobs 

Run Memory Test at AL=10 on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,AL=10. 

P,PX=yyyy. 

R , nnn . 

6/7/8/9 

Run Tape Tests on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 



Run Tape Controller Test at AL=10 on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=ATC. or GET,RFILE=ATC. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,AL=10. 

P,PX=yyyy. 

R.ATC. 

6/7/8/9 

Run Printer Tests on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,AL=10. 

P,PX=yyyy. 

R.FTP20. To load image. 

R , nnn . 

6/7/8/9 

Run Card Reader and Punch Tests on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH ,RFILE=nnn. or GET,RFILE=nnn. 

ATTACH, CR1SCR. or GET,CR1SCR. For CR1. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,AL=10. 

SCRATCH=CR1SCR. For CR1. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 



Test or Utility and Description (nnn) 



FSM 



CCM 



T7X 
T6X 
T5X 
F7X 

1ST 

ATC 



CR1 



Federal standard channel 
memory test. 

CYBER Channel Coupler 
memory test. 



67X tape transport test. 

66X tape transport test. 

60X/65X tape transport test. 

Federal standard channel 
tape subsystem test. 

Intelligent small tape 
subsystem test. 

ATS-67X controller test. 



FTP 580 fastrain printer test. 
LP1 512 printer test. 
LPE 512 exerciser. 



405 card reader test. 



CP1 415 card punch test. 
CRE 405 exerciser. 
CPE 415 exerciser. 
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Sample Jobs 

Run Communication Controller Tests on NOS: 

JOB/ ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,AL=20. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 

Run 2550 Communication Controller Tests on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH,RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,AL=20. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 

Run 2550 Diagnostic Loader on NOS: 

JOB/ACCOUNT CARDS. 

ATTACH, RFILE=TFL. or GET,RFILE=TFL. 

ATTACH, zzzzzz. or GET.zzzzzz. 

MALET.KL. 

7/8/9 

SCRATCH=zzzzzz. 

ASSIGN, EST=nn,AL=20. 

P,PK=yyyy. 

R.TFL. 

6/7/8/9 



Test or Utility and Description (nnn) 



RT3 6673/6674 communication 
controller test. 

RT5 6671 (201 or 103 mode) 

communication controller test. 

TT3 6676 (103 mode) communication 
controller test. 



TFE 2550 emulator (201 or 6671 

mode) communication controller. 

TFF 2550 coupler diagnostic. 



TFL 2550 off-line diagnostic loader. 



| NOTE 



On the ATTACH or GET of zzzzzz, all the files 
can be acquired before the MALET.KL statement, 
zzzzzz is one of the following: 

LDCHK3 Loadcheck 

MPINS Instruction test 

MPM0S MOS memory storage/addressing 

test 

M0SMA MOS memory parity/ protect test 

MPRTC Protect test 

MINEM Micromemory read/write test 

MIINS Microinstruction test 

MST041 Multiplex system test 

CEL042 Cyclic encoder test 

CPL040 6000 coupler test 

CPLX40 Expansion coupler test 

TTYA08 CRT/TTY console test 

UTOPIA Utility routines 

CCP48K CCP 1.0 diagnostics 
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Sample Jobs Test or Utility and Description (ram) 

Run Network Access Device (NAD) Tests on Local NAD on NOS: 



NOTE 



LCN must have controller running. LCI 
destroys controlware in the NAD in which it 
is running. 



JOB/ACCOUNT CARDS. LCI 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 LCN 

ASSIGN, EST=nn,DC=300 ,AL=x. 

P,PX=yyyy. 

R,nnn. LCM 

6/7/8/9 



LCN 170 device interface test. 
Must run at AL=10. 

Loosely coupled network test. 
Can run at AL=5. 



LCN memory test. Can run at AL=5. 
Run Network Access Device (NAD) Tests on Remote NAD on NOS: 



NOTE 



Because NAD is a hexadecimal machine, it is 
necessary that the access code (AC) and the 
logical trunk address (LTA) be entered as 
hexadecimal parameters using the letter H 
following the parameter value. 

Controlware must be loaded in the local NAD 
(refer to the NOS LOADBC command in the 
NOS 2 Analysis Handbook). 



JOB/ ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,DC=301,AL=6,TCU=x, 

LT A=xH , AC=xxxxH . 
P,PX=yyyy. 
R,nnn. 
6/7/8/9 



LCN Loosely coupled network test. 
LCM LCN memory test. 
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Sample Jobs 



Test or Utility and Description (nnn) 



Run Network Access Device (NAD) Tests NDM, NDP, and NDT In Local NAD on NOS 
using NAD Loader /Monitor (NLM): 

JOB /ACCOUNT CARDS. NDM NAD memory test. 

ATTACH ,RFILE=NLM. or GET,RFILE=NLM. 

ATTACH, NDM, NDP, NDT. or GET, NDM, NDP, NDT. NDP NAD processor test. 

MALET.KL. 

7/8/9 NDT NAD trunk, test. 

ASSIGN, EST=nn,DC=300,AL=5. 

SCRATCH=zzz. Where zzz is NDM, NDP or NDT. 

P,PX=yyyy. 

R.NLM. 

6/7/8/9 

Run Network Access Device (NAD) Tests on Remote NAD on NOS: 



NOTE 



Controlware must be loaded in the local NAD 
(refer to the NOS LOADBC command in the 
NOS 2 Analysis Handbook). 



JOB /ACCOUNT CARDS. 

ATTACH, RFILE=NLM. or GET,RFILE=NLM. 

ATTACH, NDM, NDP, NDT. or GET , NDM , NDP , NDT . 

MALET,KL. 

7/8/9 

ASSIGN, EST=nn,DC=301,AL=6,TCU=x,LTA=xH,AC=!CxxxH. 

SCRATCH=zzz. Where zzz is NDM, NDP or NDT. 

P,PX=yyyy. 

R.NLM. 

6/7/8/9 



Run Special Unit Tests at AL=10 on NOS: 

JOB /ACCOUNT CARDS. 

ATTACH, RFILE=nnn. or GET,RFILE=nnn. 

MALET.KL. 

7/8/9 

ASSIGN, EST=nn,AL=10. 

P,PX=yyyy. 

R,nnn. 

6/7/8/9 



CRP CYBERPLUS ring port test. 

PDP CYBER UNIBUS and PDP11 test. 

CIU PLATO communications interface 
test. 

ITU Intelligent small magnetic tape 
subsystem utility routine. 



DMA CYBERPLUS direct memory access 
unit test. 
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ACCESS LEVELS 



Table C-l describes the access levels needed while running MALET. 



Table C-l. Access Levels (Sheet 1 of 2) 



Level 



Description 



RMS 



Non-RMS 



2t 

3t 



10 



Illegal (if specified on ASSIGN). 

Read preallocated area only, 
high-level I/O. 

Read any normal data area only, 
high-level I/O. 

Read any normal data area, write 
preallocated area only, high- 
level I/O. 

Read/write any normal data area, 
high-level I/O dedicated unit. 

Illegal. 



Illegal. 



Reserved. 

For NOS: 

All removable devices on the dedi- 
cated controller must be GLOBALLY 
UNLOADED. For NOS Version 2 the 
device under test must be DOWNED. 
All SYSTEM and TEMP devices on the 
dedicated controller must be re- 
moved from the EST. For NOS Ver- 
sion 2 REDEFINEfT can be used to 
logically remove device channels 
from the EST. 



Dedicated unit, high level I/O. 
Illegal. 

Illegal. 

Illegal. 

Illegal. 



LCN NAD dedicated. Code in NAD 
assigned may be written. 

LCN NAD local and remote dedicated. 
Code may be rewritten in both NADs. 

Illegal. 

Dedicated controller and all units. 
High- and low-level I/O. May 
destroy controlware. 



tAccess level = 4 is required for READs outside preallocated areas, if SECURE has been 
defined on the intallation of MALET drivers. To lower the access level required, a 
command *PURGE,*SECURE must be used during a diagnostic PL update (REL2B/PL5). Refer to 
the NOS or NOS/BE Installation Handbook for further information. 
TtUNLOAD and REDEFINE can be referenced in the NOS 2 Operator/Analyst Handbook. 
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Table C-l. Access Levels (Sheet 2 of 2) 



Level 


Description 


RMS 


Non-RMS 


11-17 
20 

21 


For NOS/BE: 

The dedicated controller must be 
OFFED and the device under test 
must be IDLED. 

Illegal (reserved). 

For NOS: 

All removable devices on the dedi- 
cated channel must be GLOBALLY 
UNLOADED. For NOS Version 2 the 
device under test must be DOWNED. 
All SYSTEM and TEMP devices on 
the dedicated channel must be re- 
moved from the EST. For NOS Ver- 
sion 2 REDEFINE t can be used to 
logically remove device channels 
from the EST. 

For NOS/BE: 

The dedicated controller must be 
OFFED and the device under test 
must be IDLED. 

Same as 20, plus I/O channel is 
left in hung state if a channel 
hang occurs. 


Illegal (reserved). 

Dedicated channels, all units, and 
controllers. All devices must be off 
and not in use on the channel since 
master clears may be performed. High- 
and low- level I/O. Controlware may be 
destroyed. 


tuNLOAD and REDEFINE can be referenced In the NOS 2 Operator/Analyst Handbook. 



If validation is not granted and the system K/L display switch is set to off, MALET drops 
from the control point. If the K/L switch is on, an error message appears but the control 
point is not dropped. 
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MALET OUTPUT LISTING SAMPLE 



MALET output listings are illustrated in figures D-l through D-3. The content of the 
listing varies, as follows, depending upon the list options selected: 

List 
Listing Contents Options 

Items 1, 2, 9, and 12 S or none 

Items 1 through 9 I 

Items 1, 2, 5 through 16 L 

Items 1, 2, 9, 17 through 20 L and MAP 

Both L and MAP must be specified if a global cross-reference map is desired. 

Selecting the S option is not evident in the listing output, but is required if source code 
is to be carried with the module binary. 

(1) Header containing the level of MALET used to compile the module binary. This level 
corresponds to the level of the Concurrent Maintenance Library. 

(2) The date and time that the module was compiled. 

(3) Imbedded documentation not carried with the module binary. 

(4) Update correction set identifier or deckname, and sequence number of the line within 
the correction set or deck. These line identifiers appear only when the source code 
has been extracted from a program library. 

(5) Octal line number within MALET's source buffer, numbered 000 through 167 octal. 

[6J Source line statement numbers; one or two-digit octal or decimal numbers in the 
range of through 77 octal or through 63 decimal. 

(7) Source code statements recognized by the compiler. 

(8) Comments carried with the module binary (if S is selected). 

(j^) Executive directives processed by MALET, indicating the time the directive was 
processed. 

The starting PPU address where the generated instructions fll) are loaded during 



module execution 



(11) The executable PPU instructions which the compiler generated for the source line (6) 
to the left. ^^ 

(12) Header for the cross-reference table for the module indicated. 

( 1 3) The MALET executive switches, registers, and buffers referenced within the module. 
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U4J Statement numbers referenced within the module. 

(l5) The source line numbers that references the executive switches, registers, buffers 

^"^ (l3) , or statement numbers UM- 

(l(y) Informative message identifying the module which was written to the random file. 

(m Header identifying the global cross-reference map. 

(li) The executive switch, register, or buffer which was referenced. 

(T9) The module number(s) which referenced the element (l&J . 

(20) The source line within the module U9J where the element (m was referenced. 
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MALET LI 55 MAINTENANCE APPLICATION LANGUAGE FOR EQUIPMENT TESTING. 



O 



© 



© 



000 MODULE MY802,BC(02,03, 04, 05, 42,52) - RUN MY8 
*** MY802 - RUN MY8 

** MY802 - EXTERNAL DOCUMENTATION 

* OVERVIEW - 
* 

* THIS MODULE RUNS MY8 AFTER IT HAS BEEN DOWNLOADED 

* INTO THE BC BY MODULE MY801 . A 60 OCTAL WORD 

* FUNCTION TABLE IS USED TO EXCHANGE INFORMATION 

* BETWEEN THE PPU AND THE BC. A FUNCTION CODE OF 1 

* ISSUED BY THE PPU TO THE BC CAUSES THE BC TO SEND 

* THE FUNCTION TABLE TO THE PPU SO THAT PASS COUNT 

* AND ERROR STATUS CAN BE MONITORED. A FUNCTION CODE 

* OF TO THE BC CAUSES THE BC TO READ THE FUNCTION 

* (?) TABLE FROM THE PPU SO THAT THE BC CAN PERFORM THE 

* r REQUESTED ACTION (THE ONLY ACTION THAT IS REQUES- 

* / TED BY THE PPU IS TO RUN A PASS OF MY8). 

001 1 FORMAT MY802 - MY8 IS EXECUTING 

002 2 FORMAT MY8 FUNCTION TABLE 

003 3 FORMAT 0-3 = *H*H *H*H *H*H *H*H 

004 4 FORMAT 4-7 - *H*H *H*H *H*H *H*H 

005 5 FORMAT 8-B = *H*H *H*H *H*H *H*H 

006 6 FORMAT C-F = *H*H *H*H *H*H *H*H 

007 7 FORMAT MY8 PASS=*DEC SECTION»*DEC 
010 10 FORMAT ADDRESS OF ERROR (A) = *H*H 
Oil 11 FORMAT ACTUAL DATA (Bl) = *H*H 

012 12 FORMAT EXPECTED DATA (B2) = *H*H 

013 13 FORMAT ERROR STOP CODE = *H*H 

014 14 FORMAT ERROR COUNT = *DEC 

015 16 FORMAT MY802 - ABORT ON .IN. COMMAND. 

016 17 FORMAT MY802 - ABORT ON .OUT. COMMAND. 

017 20 FORMAT MY802 ERROR(S) IN MODULE = *DEC 

020 21 FORMAT MY802 - NO BC RESPONSE TO A FCN IN 30 SEC 
021 

022 30 MSG 1 TO DISPLAY, PRINT *P0ST RUNNING MESSAGE 

023 Bl = *CLEAR PASS COUNT 

024 WC = 60 (j) 



110 MSG 2 TO LINE 1 

111 GOTO 33 

112 / (J) 

113 / ABORT PROCESSOR 



84/01/26. 


07.51.45 




© 




MY8 




552 


MY8 




553 


MY8 




554 


MY8 




555 


MY8 




556 


MY8 




557 


MY8 




558 


MY8 




559 


MY8 




560 


© MY8 




561 


MY8 




562 


MY8 




563 


MY8 




564 


MY8 




565 


MY8 




566 


MY8 




567 


MY8 




568 


MY8 




569 


MY8 




617 


MY8 




618 


MY8 




619 


MY8 




620 


MY8 




621 


MY8 




622 


MY8 




623 


MY8 




624 


MY8 




625 


MY8 




626 


MY8 




627 


MY8 




628 


MY8 




629 


MY8 




630 


MY8 




631 


MY8 




632 


MY8 




633 


MY8 




634 


MY8 




635 


MY8 




636 



114 / 

115 70 B7 - B7 + 1 *BUMP ERROR COUNTER 

116 MSG 7 (B1,IB(23)) TO LINE 10 *PASS AND SECTION COUNTS 

117 MSG B5 TO LINE 11 *REPORT ABORT CONDITION 

120 MSG EM TO LINE 12 *PRODUCT OVERLAY ERROR MSG 

121 PICTURE 

122 HALT 

123 BLANK 

124 GOTO 31 

125 77 END 30 
07.51.45.DIRECTIVE=COMPILE - MY802 - 



MY8 


688 


MY8 


689 


MY8 


690 


MY8 


691 


MY8 


692 


MY8 


693 


MY8 


694 


MY8 


695 


MY8 


696 


MY8 


697 


MY8 


698 


MY8 


699 


MY8 


700 


MY8 


701 


MY8 


702 



© 



Figure D-l . MALET Source Listing: List Option I 
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MALET L155 MAINTENANCE APPLICATION LANGUAGE FOR EQUIPMENT TESTING. 84/01/26. 07.51.45. 



000 
001 
002 
003 
004 
005 
006 
007 
010 
Oil 
012 
013 
014 
015 
016 
017 
020 
021 
022 

3401 1455 
023 
024 
025 

3401 1401 
026 
027 
030 

5447 0200 
031 
032 



MODULE MY802,BC(02,03,04,05,42,52) - RUN MY8 
FORMAT MY802 - MY8 IS EXECUTING 



FORMAT MY8 FUNCTION TABLE 
FORMAT 0-3 = *H*H *H*H *H*H *H*H 
FORMAT 4-7 = *H*H *H*H *H*H *H*H 
FORMAT 8-B = *H*H *H*H *H*H *H*H 
FORMAT C-F = *H*H *H*H *H*H *H*H 
7 FORMAT MY8 PASS=*DEC SECTION=*DEC 

10 FORMAT ADDRESS OF ERROR (A) - *H*H 

11 FORMAT ACTUAL DATA (Bl) = *H*H 

12 FORMAT EXPECTED DATA (B2) = *H*H 

13 FORMAT ERROR STOP CODE « *H*H 

14 FORMAT ERROR COUNT - *DEC 

16 FORMAT MY802 - ABORT ON .IN. COMMAND. 

17 FORMAT MY802 - ABORT ON .OUT. COMMAND. 

20 FORMAT MY802 ERROR(S) IN MODULE = *DEC 

21 FORMAT MY802 - NO BC RESPONSE TO A FCN IN 30 SEC 



30 MSG 1 TO DISPLAY, PRINT 
0200 2367 

Bl = 
WC = 60 

31 MSG 2 TO LINE 1 
0200 2367 

BO = 

32 RES 

FUNC 1, ABT 40 
4544 

BO = 
B5 = 16 



*P0ST RUNNING MESSAGE 



*CLEAR PASS COUNT 



*CLEAR FUNCTION RETRY COUNT 
*GET CHANNEL 



£> 



♦REQUEST FUNCTION TABLE FROM BC 1133^ 



*CLEAR FUNCTION RETRY COUNT 



100=1401 3402 1400 3403 



1110-1400 3421 
1112=1460 3430 
1114=1402 3402 1400 3403 

1124=1400 3420 

1126=1427 3446 1400 0200 4520 
=3646 1401 3410 2033 

1142=1400 3420 
1144=1416 3425 



110 MSG 2 TO LINE 1 
3401 1401 0200 2367 



111 
112 
113 
114 
115 
116 



GOTO 33 



-ABORT PROCESSOR- 



70 B7 = B7 + 1 

MSG 7 (B1,IB(23)) TO LINE 
5000 6513 3410 1402 3403 1400 3401 



*BUMP ERROR COUNTER 
10 *PASS AND SECTION COUNTS 



117 MSG B5 TO LINE 11 
3401 1411 0200 2367 

120 MSG EM TO LINE 12 
3401 1412 0200 2367 



1620=1402 3402 1400 3403 
1630=2023 1306 0100 2414 



1634=3027 1601 3427 
1637=1407 3402 3021 3407 

1410 0200 2367 
1655=3025 3402 1400 3403 



121 
122 
123 
124 
125 



PICTURE 
HALT 
BLANK 
GOTO 31 
77 END 30 



*REPORT ABORT CONDITION 

♦PRODUCT OVERLAY ERROR MSG 1665=3051 3402 1400 3403 

1675=1400 0200 2377 
1700=1400 0200 2353 
1703=1403 0200 2305 
1706=2012 5114 0100 2414 
1712=0100 2330 



Figure D-2. MALET Source Listing: List Option L (Sheet 1 of 2) 
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CROSS-REFERENCE 


TABLE 


FOR 




802 
















BO 




026 




031 




071 














Bl 




023 




042 




054 


057 


116 










B5 




032 




047 




051 


072 


117 










B7 ^\ 




061 




062 




103 


103 


104 115 


115 








CM (13) 




060 






















EM V ~ / 




120 






















ES 




060 






















IB 




035 




036 




037 


040 


041 042 


045 054 055 


056 


077 


077 


IB 




100 




100 




101 


101 


102 102 


116 








3 




00 3 




036 






© 












30 




022 




125 


















31 




025 




060 




124 














32 




027 




055 




056 


057 


071 










33 /~\ 

34 (14) 

35 v - / 




046 
054 
061 




111 
063 


















4 




004 




037 


















40 




030 




067 


















5 




005 




040 


















50 




045 




077 


















6 




006 




041 


















7 




007 




042 




054 


116 












70 




033 




050 




052 


073 


115 










77 
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Figure D-2 . MALET Source Listing: List Option L (Sheet 2 of 2) 



60455980 L 



D-5 



MALET LI 55 


MAINTENANCE APPLICATION LANGUAGE FOR EQUIPMENT TESTING. 




84/01/26. 05 


.51 


.45. 








O 


























GLOBAL 


CROSS-REFERENCE MAP 






















BO 


MY801 
MY802 
MY803 






026 
026 

031 


026 

031 
031 


027 
071 
033 


037 
043 
















Bl 


MY800 






020 


046 






















MY801 






021 


022 


032 


052 


053 


067 




070 








@ 


MY802 






023 


042 


054 


057 


116 














MY803 


© 




024 


025 


036 


063 


064 


101 




102 








B2 


MY800 




061 


062 






















MY803 






032 


046 


055 


















B3 


MY800 






056 


061 


061 


062 


062 


062 




064 








B4 








057 


062 


063 


063 


















MY803 




© 


052 


053 


054 


056 


125 


141 




142 




143 


144 


B5 


MY800 




023 


025 


027 


032 


034 


036 




040 




060 


074 


. 


MY801 






057 


06 5 


075 


100 


122 














WC 


MY800 
MY801 
MY802 






021 
060 

024 


041 
063 


065 

064 


073 


074 
















MY803 






072 


075 


076 


105 


106 


130 




131 








WT 


MY800 






030 


037 


060 




















MY801 






025 


042 


043 


060 


063 


071 




072 




073 






MY803 






030 


047 


050 


072 


075 


103 




104 




105 


136 


137 
































F 


Lgure 


D-3 


. MALET 


Global 


Cross- 


-Reference 


Map: List 


Options 


L and 


MAP 







D _ 6 60455980 L 



COMMENT SHEET 

MANUAL TITLE- ^^ Concurrent Maintenance Library 
Reference Manual 

PUBLICATION NO.: 60455980 REVISION: 
NAME: 



COMPANY: 



STREET ADDRESS: 



CITY: STATE: ZIP CODE: 



This form it not intended to be used as an order blank. Control Data Corporation welcomes your evaluation of 
this manual. Please indicate any errors, suggested additions or deletions, or general comments below (please 
include page number references). 

D Please Reply □ No Reply Necessary 



NO POSTAGE STAMP NECESSARY IF MAILED IN U.S.A. 

KID ON DOTTED LINES AND TAPE 



FOID 



FOLD 



BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO 8241 MINNEAPOLIS. MN 



] 



POSTAGE WILL BE PAID BY ADDRESSEE 

CONTRPL DATA 

Technology and Publications Division 

ARH219 

4201 North Lexington Avenue 

Saint Paul, MN 55126-6198 



NO POSTAGE 

NECESSARY 

IF MAILED 

IN THE 

UNITED STATES 



FOLD 



FOID 



CORPORATE HEADQUARTERS, P.O. BOX 0, MINNEAPOLIS, MINN 55440 LITHO IN I 

SALES OFFICES AND SERVICE CENTERS IN MAJOR CITIES THROUGHOUT THE WORLD 



CONTRpL DATA 



